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Chapter 1 

Introduction 




ASSEMBLER OPERATION 

ASM-86 processes an 8086 assembly language source file in three passes and 
produces three output files, including an 8086 machine language file in hexadecimal 
format. This object file may be in either Intel or Digital Research hex format, both 
of which are described in Appendix C. ASM-86 typically produces three output files 
from one input source file as shown in Figure 1-1. 
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filename. A86 — contains source 

filename.LST — contains listing 

filename. H86 — contains assembled program in hexadecimal format 

filename. SYM — contains all user-defined symbols 

Figure 1-1 ASM-86 Source and Object Files 

Figure 1-1 also lists ASM-86 filename extensions. ASM-86 accepts a source file with 
any three letter extension. However, if the extension is omitted from the command 
line entry, ASM-86 looks for the specified file name with the extension .A86 in the 
directory. If the file has an extension other than .A86 or has no extension at all, 
ASM-86 returns an error message. 

The other extensions listed in Figure 1-1 identify ASM-86 output files. The .LST file 
contains the assembly language listing with any error messages. The .H86 file 
contains the machine language program in either Digital Research or Intel hexa- 
decimal format. The .SYM file lists any user-defined symbols. 
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To invoke ASM-86, enter a command using the following form: 

ASM86 source filename {$ optional parameters} 

Specifications for the optional parameters, which generally affect the assembly 
output, are described in the next section. The source file is specified using the 
following form: 

{d:\filename. {filetype} 

where 

d: is a valid drive letter specifying the source file's location. Not 

needed if source is on current drive. 

filename is a valid CP/M filename of 1 to 8 characters. 

filetype is a valid file extension of 1 to 3 characters, usually A86. 

The following are examples of valid ASM-86 commands: 

A>ASM86 B:BIOS88 

A-ASM86 BIOS88.A86 $FI AA HB PB SB 

A>ASM86 D:TEST 

Once invoked, ASM-86 responds with the message: 

CP/M 8086 ASSEMBLER VER x.x 

where x.x is the ASM-86 version number. ASM-86 then attempts to open the source 
file. If the file does not exist on the designated drive, or does not have the correct 
extension as described above, the assembler displays the message: 

NO FILE 

If an invalid parameter is given in the optional parameter list, ASM-86 aborts and 
displays the message: 

PARAMETER ERROR 

After opening the source file, the assembler creates the output files. Usually these 
files are located on the current drive, but they may be redirected using the optional 
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parameters, or by a drive specification in the source file name. In the latter case, 
ASM-86 directs the output files to the drive specified in the source file name. 

During assembly, ASM-86 aborts if an error condition such as a full disk or symbol 
table overflow is detected. When ASM-86 detects an error in the source file, it places 
an error message line in the listing file in front of the line containing the error. 

Each error message has a number and gives a brief explanation of the error. 
Appendix H lists ASM-86 error messages. When the assembly is complete, ASM-86 
displays the message: 

END OF ASSEMBLY. NUMBER OF ERRORS: n 

The system also prints a message indicating the percentage of symbol table space 
that was used in the assembly. 

OPTIONAL RUNTIME PARAMETERS 

The dollar sign character ($) introduces an optional string of runtime parameters in 
the command line. A parameter is a single letter that must be followed by another 
single letter argument indicating the device name specification. The parameters are 
shown in Table 1-1. 

Table 1-1 Runtime Parameter Summary 



PARAMETER 


TO SPECIFY 


VALID ARGUMENTS 


A 


source file device 


A... H, X,Y, Z 


H 


hex output file device 


A... H, X, Y, Z 


P 


list file device 


A... H, X,Y, Z 


S 


symbol file device 


A... H, X, Y, Z 


F 


format of hex output file 


I,D 



All parameters are optional, and can be entered in the command line in any order. 
Enter the dollar sign only once at the beginning of the parameter string. Spaces may 
separate parameters, but are not required. No space is permitted, however, between 
a parameter and its device name. 

A device name must follow parameters A, H, P and S. Use the following device 
names: 

A, B, C, D or X, Y, Z 
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Device names A through D respectively specify floppy diskette drives A through D. 
Device names E and F specify the two partitions in hard disk unit 0. Devices G and 
H specify the two partitions in hard disk unit 1 . X specifies the user console (CON:), 
Y specifies the line printer (LST:), and Z suppresses output (NUL:). 

If output is directed to the console, it may be temporarily stopped at any time by 
pressing CTRL-S . Restart the output by pressing CTRL-S a second time or by 
pressing any other character. 



The F parameter requires either an I or a D argument. When I is specified, ASM-86 
produces an object file in Intel hex format. A D argument requests Digital Research 
hex format. Appendix C discusses these formats in detail. If the F parameter is not 
entered in the command line, ASM-86 produces Digital Research hex format. 

The following table gives examples of valid ASM-86 command line entries. 
Table 1-2 Runtime Parameter Examples 



COMMAND LINE 


RESULT 


ASM86 IO 


Assemble file IO.A86, produce IO.HEX, IO.LST 




and IO.SYM, all on the default drive. 


ASM86 IO.ASM $ AD SZ 


Assemble file IO.ASM on device D, produce 




IO.LST and IO.HEX, no symbol file. 


ASM86 IO $ PY SX 


Assemble file IO.A86, produce IO.HEX, route list- 




ing directly to printer, output symbols on 




console. 


ASM86 IO $ FD 


Produce Digital Research hex format. 


ASM86 IO $ FI 


Produce Intel hex format. 



ABORTING ASM-86 

You may abort ASM-86 execution at any time by pressing any key on the APC 
keyboard. When a key is pressed, ASM-86 responds with the question: 

USER BREAK. OK(Y/N)? 

Enter Y to abort the assembly and return to the operating system. Enter N to 
continue the assembly. 
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Chapter 2 

Elements of ASM-86 Assembly 
Language 

ASM-86 CHARACTER SET 

ASM-86 recognizes a subset of the ASCII character set. The valid characters are the 
alphanumerics, special characters, and nonprinting characters shown below: 

ABCDEFGHI JKLMNOPQRSTUVWXYZ 

abcde fgh i j k lmnopqr s t uvwxyz 
0123456789 




+ 



/ = ()[] 



space, tab, carriage return, and line feed 

Lowercase letters are treated as uppercase except within strings. Only alpha- 
numerics, special characters, and spaces may appear within a string. 

TOKENS AND SEPARATORS 

A token is the smallest meaningful unit of an ASM-86 source program, much as a 
word is the smallest meaningful unit of an English composition. Adjacent tokens 
are commonly separated by a blank character or space. Any sequence of spaces may 
appear wherever a single space is allowed. ASM-86 recognizes horizontal tabs as 
separators and interprets them as spaces. Tabs are expanded to spaces in the list file. 
The tab stops are at each eighth column. 

DELIMITERS 

Delimiters mark the end of a token and add special meaning to the instruction, as 
opposed to separators, which merely mark the end of a token. When a delimiter is 
present, separators need not be used. However, separators entered after delimiters 
can make your program easier to read. 

Table 2-1 describes ASM-86 separators and delimiters. Some delimiters are also 
operators and are explained in greater detail later in the chapter. 
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Table 2-1 Separators 


and Delimiters 


CHARACTER 


NAME 


USE 


20H 


space 


separator 


09H 


tab 


legal in source files, expanded in 
list files 


CR 


carriage return 


terminates source lines 


LF 


line feed 


legal after CR; if within source 
lines, it is interpreted as a space 


5 


semicolon 


starts comment field 




colon 


identifies a label, used in segment 
override specification 




period 


forms variables from numbers 


S 


dollar sign 


notation for "present value of 
location pointer" 


+ 


plus 


arithmetic operator for addition 


- 


minus 


arithmetic operator for subtrac- 
tion 


* 


asterisk 


arithmetic operator for multipli- 
cation 


/ 


slash 


arithmetic operator for division 


@ 


at sign 


legal in identifiers 





underscore 


legal in identifiers 
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Table 2-1 Separators and Delimiters (cont'd) 



CHARACTER 


NAME 


USE 


I 


exclamation 
point 

apostrophe 


logically terminates a statement, 
thus allowing multiple statements 
on a single source line 

delimits string constants 



CONSTANTS 

A constant is a value known at assembly time that does not change while the 
assembled program is executed. A constant may be either an integer or a character 
string. 

Numeric Constants 

A numeric constant is a 16-bit value in one of several bases. The base, called the 
radix of the constant, is identified by a radix indicator that follows the numeric 
constant. The radix indicators are shown in Table 2-2. 

Table 2-2 Radix Indicators for Constants 



INDICATOR 


CONSTANT TYPE 


BASE 


B 


binary 


2 


O 


octal 


8 


Q 


octal 


8 


D 


decimal 


10 


H 


hexadecimal 


16 



ASM-86 assumes that any numeric constant not terminated with a radix indicator is 
a decimal constant. Radix indicators may be represented in either uppercase or 
lowercase. 

A constant is thus a sequence of digits followed by an optional radix indicator, 
where the digits are in the range allowed for the radix. Binary constants must be 
composed of 0s and Is. Octal digits range from to 7; decimal digits range from to 
9. Hexadecimal constants contain decimal digits as well as the hexadecimal digits A 
(10D), B (11D), C (12D), D (13D), E (14D), and F (15D). Note that the leading 
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character of a hexadecimal constant must be either a decimal digit so that ASM-86 
cannot confuse a hex constant with an identifier, or leading to prevent this 
problem. The following are valid numeric constants: 



1234 


1234D 


1100B 


111100001 1110000B 


1234H 


OFFEH 


33770 


13772Q 


33770 


0FE3H 


1234d 


Offffh 



Character Strings 

ASM-86 treats an ASCII character string delimited by apostrophes as a string 
constant. All instructions accept only one- or two-character constants as valid 
arguments. Instructions treat a one-character string as an 8-bit number. A two- 
character string is treated as a 16-bit number with the value of the second character 
in the low-order byte, and the value of the first character in the high-order byte. 

The numeric value of a character is its ASCII code. ASM-86 does not translate case 
within character strings, so both uppercase and lowercase letters can be used. Note 
that only alphanumerics, special characters, and spaces are allowed within strings. 

A DB assembler directive is the only ASM-86 statement that may contain strings 
longer than two characters. The string may not exceed 255 bytes. To include an 
apostrophe to be printed within the string, enter it twice. ASM-86 interprets the two 
keystrokes (") as a single apostrophe. Table 2-3 shows valid strings and how they 
appear after processing. 

Table 2-3 String Constant Examples 



ENTERED AS: 


INTERPRETED AS 


'a' 

'Ab' 'Cd' 

T like CP/M' 

'ONLY UPPER CASE' 

'only lower case' 


a 

Ab'Cd 

I like CP/M 

ONLY UPPER CASE 

only lower case 



ASM-86 flags an incomplete string, a string without a terminating quotation mark, 
as an error. 

IDENTIFIERS 

Identifiers are character sequences that have a special, symbolic meaning to the 
assembler. All identifiers in ASM-86 must obey the following rules: 
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• The first character must be alphabetic (A,...Z, a,...z). 

• Any subsequent characters can be either alphabetical or numeric (0, 1, 9). 

ASM-86 ignores the special characters @ and _, but they are still legal. For 
example, a_b becomes ab. 

• Identifiers may be any length up to the limit of the physical line. 

Two types of identifiers can be used. Keywords have predefined meanings to the 
assembler. Symbols are defined by the user. The following are all valid identifiers: 



NOLIST 

WORD 

AH 

Third_street 
How_are_you_today 
variable@number@ 1 234567890 

Keywords 

A keyword is an identifier that has a predefined meaning to the assembler. Key- 
words are reserved; the user cannot define an identifier identical to a keyword. For a 
complete list of keywords, see Appendix D. 

ASM-86 recognizes five types of keywords: instructions, directives, operators, 
registers, and predefined numbers. 8086 instruction mnemonic keywords and the 
actions they initiate are defined in Chapter 4. Directives are discussed in Chapter 3. 
Operators are described later in this chapter. Table 2-4 lists the ASM-86 keywords 
that identify 8086 registers. 

Three keywords are predefined numbers: BYTE, WORD, and DWORD. The 
values of these numbers are 1, 2 and 4, respectively. In addition, a Type attribute is 
associated with each of these numbers. The Type attribute of the keyword is equal 
to the keyword's numeric value. The next section provides a complete discussion of 
Type attributes. 
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Table 2-4 Register Keywords 



REGISTER 




NUMERIC 




SYMBOL 


SIZE 


VALUE 


MEANING 


AH 


1 byte 


100 B 


Accumulator-High-Byte 


BH 


1 " 


111 B 


Base-Register-High-Byte 


CH 


1 " 


101 B 


Count-Register-High-Byte 


DH 


i " 


HOB 


Data-Register-High-Byte 


AL 


i " 


000 B 


Accumulator-Low-Byte 


BL 


i " 


Oil B 


Base-Register-Low-Byte 


CL 


i " 


001 B 


Count-Register-Low-Byte 


DL 


i " 


010 B 


Data-Register-Low-Byte 


AX 


2 bytes 


000 B 


Accumulator (full word) 


BX 


2 " 


Oil B 


Base-Register 


CX 


2 " 


001 B 


Count-Register 


DX 


2 " 


010 B 


Data-Register 


BP 


2 " 


101 B 


Base Pointer 


SP 


2 " 


100 B 


Stack Pointer 


SI 


2 " 


HOB 


Source Index 


DI 


2 " 


111 B 


Destination Index 


CS 


2 " 


01 B 


Code-Segment-Register 


DS 


2 " 


11 B 


Data-Segment-Register 


SS 


2 " 


10 B 


Stack-Segment- Register 


ES 


2 " 


00 B 


Extra-Segment-Register 



Symbols and Their Attributes 

A symbol is a user-defined identifier with attributes that specify what kind of 
information the symbol represents. Symbols fall into three categories: 



• variables 

• labels 

• numbers 



Variables identify data stored at a particular location in memory. All variables have 
the following three attributes: 
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• Segment — tells which segment was being assembled when the variable was 
defined. 

• Offset — tells how many bytes there are from the beginning of the segment 
to the location of this variable. 

• Type — tells how many bytes of data are manipulated when this variable is 
referenced. 

A Segment may be a code-segment, a data-segment, a stack-segment or an extra- 
segment depending on its contents and the register that contains its starting address 
(see Chapter 3). A segment may start at any address divisible by 16. ASM-86 uses 
this boundary value as the Segment portion of the variable's definition. 

The Offset of a variable may be any number between and OFFFFH (65535D). A 
variable must have one of the following Type attributes: 

• BYTE 

• WORD 

• DWORD 

BYTE specifies a one-byte variable, WORD a two-byte variable, and DWORD a 
four-byte variable. The DB, DW, and DD directives respectively define variables as 
these three types (see Chapter 3). For example, a variable is defined when it appears 
as the name for a storage directive: 

VARIABLE DB 

A variable may also be defined as the name in an EQU directive referencing another 
label, as shown below. 

VARIABLE EQU ANOTHER_VARIABLE 

Labels identify locations in memory that contain instruction statements. They are 
referenced with jumps or calls. All labels have two attributes: 

• Segment 

• Offset 
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Label segment and offset attributes are essentially the same as variable segment and 
offset attributes. Generally, a label is defined when it precedes an instruction. A 
colon (:) separates the label from the instruction, as shown in the following example. 

LABEL: ADD AX,BX 

A label may also appear as the name in an EQU directive referencing another label, 
as shown in the following example. 

LABEL EQU ANOTHER_LABEL 

Numbers may also be defined as symbols. A number symbol is treated as if you had 
explicitly coded the number it represents. For example: 

Number_five EQU 5 
MOV AL, Number_five 

is equivalent to: 

MOV AL,5 

The following section describes operators and their effects on numbers and number 
symbols. 

OPERATORS 

ASM-86 operators fall into the following categories: 

arithmetic 

logical 

relational 

segment override 

variable manipulators and creators. 

Table 2-5 defines ASM-86 operators. In this table, a and b represent two elements of 
the expression. The validity column defines the type of operands the operator can 
manipulate, with the bar character ( |) indicating alternatives. 
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Table 2-5 ASM-86 Operators 



SYNTAX 


RESULT 


VALIDITY 


Logical Operators 


aXORb 


Bit-by-bit logical EXCLUSIVE 
OR of a and b 


a, b = number 


aORb 


Bit-by-bit logical OR of a 
and b 


a, b = number 


aANDb 


Bit-by-bit logical AND of a 
and b 


a, b = number 


NOT a 


Logical inverse of a: all O's 
become l's, l's become O's 


a = 16-bit number 


Relational Operators 


aEQb 


OFFFFHifa = Z>, 
otherwise 0. 


a,b = 

unsigned number 


aLTb 


0FFFFHiftf<6, 
otherwise 0. 


a,b = 

unsigned number 


a LE b 


OFFFFH if <*<=&, 
otherwise 0. 


a,b = 

unsigned number 


aGTb 


0FFFFHifa>6, 
otherwise 0. 


a,b = 

unsigned number 


a GE b 


0FFFFHifa> = 6, 
otherwise 0. 


a,b = 

unsigned number 


aNEb 


OFFFFHifaOfr, 
otherwise 0. 


a,b = 

unsigned number 
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Table 2-5 ASM-86 Operators (cont'd) 



SYNTAX 


RESULT 


VALIDITY 


Arithmetic Operators 


a + b 


Arithmetic sum of a and b 


a = variable, 
label or number 
b = number 


a-b 


Arithmetic difference of 


a = variable, 




a and b 


label or number 
b = number 


a* b 


Unsigned multiplication 
of a and b 


a, b = number 


a/b 


Unsigned division of a 
and& 


a, b, = number 


aMOT>b 


Remainder of a / b 


a, b, = number 


aSHLfc 


Value that results from 
shifting a to left by an amount b 


a, b, =, number 


aSHRb 


Value that results from 

shifting a to the right by an amount b 


a, b, = number 


+ a 


a 


a = number 


- a 


0-a 


a = number 


Segment Override 


seg reg: 
addr exp 


Overrides assembler's choice 
of segment register 


< seg reg > = 
CS, DS, SS 
or ES 
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Table 2-5 ASM-86 Operators (cont'd) 



SYNTAX 


RESULT 


VALIDITY 


Variable Manipulators, Creators 


SEGa 


Number whose value is the 
segment value of the variable 
or label a 


a = label | 
variable 


OFFSET a 


Number whose value is the 
offset value of the variable 
or label a 


a = label | 
variable 


TYPE a 


Number - If the variable a 

is of type BYTE, WORD 

or DWORD, the value of the number 

will be 1,2 or 4, respectively. 


a = label | 
variable 


LENGTH a 


Number whose value is the 
LENGTH attribute of the variable 
a - The length attribute is the 
number of bytes associated with 
the variable. 


a = label | 
variable 


LAST a 


If LENGTH a > 0, then LAST a = 
LENGTH a - 1. If LENGTH a = 
0, then LAST a = 0. 


a = label | 
variable 


aPTRb 


Virtual variable or label 
with type of a and 
attributes of b 


a = BYTE | 
WORD, | DWORD 
b = <addr exp> 


.a 


Variable with an offset 
attribute of a. Segment attribute 
is current segment. 


a = number 
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Table 2-5 ASM-86 Operators (cont'd) 



SYNTAX 


RESULT 


VALIDITY 


Arithmetic Operators 


$ 


Label with offset equal to 
current value of location 
counter; segment attribute 
is current segment. 


no argument 



Operator Examples 

Logical operators perform the Boolean logic operations AND, OR, XOR, and 
NOT, accepting only numbers as operands. For example: 



OOFC 


MASK 


EQU 


0FCH 


0080 


SIGNBIT 


EQU 


80H 


0000 B 180 




MOV 


CL,MASK AND SIGNBIT 


0002 B003 




MOV 


AL,NOT MASK 



Relational operators treat all operands as unsigned numbers. The relational opera- 
tors are EQ (equal), LT (less than), LE (less than or equal), GT (greater than), GE 
(greater than or equal), and NE (not equal). Each operator compares two operands 
and returns all ones (0FFFFH) if the specified relation is true and all zeros if it is 
not. For example: 



000A 
0019 



LIMIT1 
LIMIT2 



EQU 
EQU 



10 

25 



0004 B8FFFF 
0007 B80000 



MOV AX,LIMIT1 LT LIMIT2 
MOV AXXIMIT1 GT LIMIT2 



Addition and subtraction operators compute the arithmetic sum and difference of 
two operands. The first operand may be a variable, label, or number, but the second 
operand must be a number. When a number is added to a variable or label, the result 
is a variable or label whose offset is the numeric value of the second operand plus the 
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offset of the first operand. Subtraction from a variable or label returns a variable or 
label whose offset is that of first operand decremented by the number specified in 
the second operand. For example: 

0002 
0005 
000A FF 



COUNT 


EQU 


2 


DISP1 


EQU 


5 


FLAG 


DB 


0FFH 



000B 2EA00B00 
000F 2E8A0E0F00 
0014 B303 



MOV AL,FLAG+1 
MOV CL,FLAG+DISP1 
MOV BL,DISPl-COUNT 



The multiplication and division operators *, /, MOD, SHL, and SHR accept only 
numbers as operands. The operators, * and /, treat all operators as unsigned 
numbers. For example: 



0016 BE5500 

0019 B310 

0050 

00 IB B8A000 



BUFFERSIZE 



MOV SI.256/3 
MOV BL,64/4 
EQU 80 
MOV AX,BUFFERSIZE * 2 



Unary operators accept both signed and unsigned operators as shown below: 



001EB123 
0020 B007 
0022 B2F4 



MOV 
MOV 
MOV 



CL,+35 
AL,2--5 
DL,-12 



When manipulating variables, the assembler decides which segment register to use. 
You may override the assembler's choice by specifying a different register with the 
segment override operator. The syntax for the override operator is as follows: 

segment registenaddress expression 

where the segment register is CS, DS, SS, or ES. For example: 



0024 3688B472D 
0028 268B0E5B00 



MOV AX,SS:WORDBUFFER[BX] 
MOV CX,ES:ARRAY 
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A variable manipulator creates a number equal to one attribute of its variable 
operand. SEG extracts the variable's segment value, OFFSET its offset value, 
TYPE its type value (1, 2, or 4), and LENGTH the number of bytes associated with 
the variable. LAST compares the variable's LENGTH with and if greater, then 
decrements LENGTH by one. If LENGTH equals 0, LAST leaves it unchanged. 
Variable manipulators accept only variables as operators. For example: 



002D 000000000000 
0033 0102030405 



WORDBUFFER DW 0,0,0 

BUFFER DB 1,2,3,4,5 



0038 B80500 
0038 B80400 
003E B80100 
0041 B80200 



MOV AX,LENGTH BUFFER 

MOV AX,LAST BUFFER 

MOV AX,TYPE BUFFER 

MOV AX/TYPE WORDBUFFER 



The PTR operator creates a virtual variable or label, that is, one valid only during 
the execution of the instruction. PTR makes no changes to either of its operands. 
The temporary symbol has the same Type attribute as the left operator, and all 
other attributes of the right operator as shown below. 



0044 C60705 
0047 8A07 
0049 FF04 



MOV BYTE PTR [BX], 5 
MOV AL,BYTE PTR [BX] 
INC WORD PTR [SI] 



The Period operator (.) creates a variable in the current data segment. The new 
variable has a segment attribute equal to the current data segment and an offset 
attribute equal to its operand. Its operand must be a number. For example: 



0048 A 10000 
004E268B1E0040 



MOV AX, .0 

MOV BX, ES: .4000H 



The Dollar sign operator ($) creates a label with an offset attribute equal to the 
current value of the location counter. The label's segment value is the same as the 
current code segment. This operator takes no operand. For example: 



0053 E9FDFF 
0056 EBFE 
0058 E9FD2F 



JMP $ 

JMPS $ 
JMP $+3000H 
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Operator Precedence 

Expressions combine variables, labels or numbers with operators. ASM-86 allows 
several kinds of expressions (discussed in the next section). If more than one 
operator appears in an expression, the operations they perform occur in a specific 
order of precedence. 

In general, ASM-86 evaluates expressions left to right, but operators with higher 
precedence are evaluated before operators with lower precedence. When two opera- 
tors have equal precedence, the leftmost is evaluated first. Table 2-6 presents 
ASM-86 operators in order of increasing precedence. 

Parentheses can override normal rules of precedence. The part of an expression 
enclosed in parentheses is evaluated first. If parentheses are nested, the innermost 
expressions are evaluated first. However, only five levels of nested parentheses are 
legal. For example: 

15/3+ 18/9 = 5 + 2 = 7 

15/(3 + 18/9) = 15/(3 + 2) = 15/5 =3 

Table 2-6 Precedence of Operations in ASM-86 



ORDER 


OPERATOR TYPE 


OPERATORS 


1 


Logical 


XOR, OR 


2 


Logical 


AND 


3 


Logical 


NOT 


4 


Relational 


EQ, LT, LE, GT, 
GE, NE 


5 


Addition/subtraction 


+,- 


6 


Multiplication/division 


*, /, MOD, SHL, 
SHR 


7 


Unary 


+,- 


8 


Segment override 


< segment override>: 
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Table 2-6 Precedence of Operations in ASM-86 (cont'd) 



ORDER 


OPERATOR TYPE 


OPERATORS 


9 

10 
11 


Variable manipulators, 
creators 

Parentheses/brackets 

Period and Dollar 


SEG, OFFSET, PTR, 
TYPE, LENGTH, LAST 

(),[] 



EXPRESSIONS 

ASM-86 allows address, numeric, and bracketed expressions. An address expres- 
sion evaluates to a memory address and has three components: 

• a segment value 

• an offset value 

• a type 

Both variables and labels are address expressions. An address expression is not a 
number, but its components are. Numbers may be combined with operators such as 
PTR to make an address expression. 

A numeric expression evaluates to a number. It does not contain any variables or 
labels, only numbers and operands. 

Bracketed expressions specify base- and index-addressing modes. The base registers 
are BX and BP, and the index registers are DI and SI. A bracketed expression may 
consist of a base register, an index register, or both a base register and an index 
register. 

Use the + operator between a base register and an index register to specify both 
base- and index-register addressing. For example: 

MOV variable[bx],0 
MOV AX,[BX+DI] 
MOV AX,[SI] 
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STATEMENTS 

Just as tokens in the ASM-86 assembly language correspond to words in English, so 
are statements analogous to sentences. A statement tells ASM-86 what action to 
perform. Two types of statements are used: instructions and directives. Instructions 
are translated by the assembler into 8086 machine language instructions. Directives 
are not translated into machine code but instead direct the assembler to perform 
certain clerical functions. 

Terminate each assembly language statement with a carriage return (CR) and line 
feed (LF), or with an exclamation point ( !), which ASM-86 treats as an end-of-line. 
Multiple assembly language statements can be written on the same physical line if 
separated by exclamation points. 

The AS instruction set is defined in Chapter 4. The following is the syntax for an 
instruction statement. 

{label:} {prefix} mnemonic {operand(s)} {;comment} 

where the fields are defined as follows: 



label: 



prefix 



mnemonic 



operand(s) 



comment 



A symbol followed by ":" defines a label at the current 
value of the location counter in the current segment. This 
field is optional. 

Certain machine instructions such as LOCK and REP 
may prefix other instructions. This field is optional. 

A symbol defined as a machine instruction, either by the 
assembler or by an EQU directive. This field is optional 
unless preceded by a prefix instruction. If it is omitted, no 
operands may be present, although the other fields may 
appear. ASM-86 mnemonics are defined in Chapter 4. 

An instruction mnemonic may require other symbols to 
represent operands to the instruction. Instructions may 
have zero, one or two operands. 

Any semicolon (;) appearing outside a character string 
begins a comment. A comment is ended by a carriage 
return. An exclamation point in a comment is ignored 
and is not treated as a delimiter. Comments improve the 
readability of programs. This field is optional. 



2-17 



Elements of ASM-86 Assembly Language 



ASM-86 directives are described in Chapter 3. The following is the syntax for a 
directive statement: 

{name} directive operand(s) {;comment} 

where the fields are defined as follows: 



name 



directive 
operand(s) 

comment 



Unlike the label field of an instruction, the name field of a 
directive is never terminated with a colon. Directive 
names are legal for only DB, DW, DD, RS and EQU. For 
DB, DW, DD and RS the name is optional; for EQU it is 
required. 

One of the directive keywords defined in Chapter 3. 

Analogous to the operands to the instruction mnemon- 
ics. Some directives, such as DB, DW, and DD, allow any 
operand while others have special requirements. 

Exactly as defined for instruction statements. 
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INTRODUCTION 

Directive statements cause ASM-86 to perform housekeeping functions such as 
assigning portions of code to logical segments, requesting conditional assembly, 
defining data items, and specifying listing file format. General syntax for directive 
statements appears in Chapter 2. 

In the sections that follow, the specific syntax for each directive statement is given 
under the heading and before the explanation. These syntax lines use special 
symbols to represent possible arguments and other alternatives. Brackets, { }, 
enclose optional arguments. Angle brackets, < >, enclose descriptions of user- 
supplied arguments. Do not include these symbols when coding a directive. 

SEGMENT START DIRECTIVES 

At runtime, every 8086 memory reference must have a 16-bit segment base value 
and a 16-bit offset value. These are combined to produce the 20-bit effective address 
needed by the CPU to physically address the location. The 16-bit segment base 
value or boundary is contained in one of the segment registers CS, DS, SS, or ES. 
The offset value gives the offset of the memory reference from the segment bound- 
ary. A 16-byte physical segment is the smallest relocatable unit of memory. 

ASM-86 predefines four logical segments: the Code Segment, Data Segment, Stack 
Segment, and Extra Segment, which are respectively addressed by the CS, DS, SS, 
and ES registers. Future versions of ASM-86 will support additional segments such 
as multiple data or code segments. All ASM-86 statements must be assigned to one 
of the four currently supported segments so that they can be referenced by the CPU. 
A segment directive statement, CSEG, DSEG, SSEG, or ESEG, specifies that the 
statements following it belong to a specific segment. The statements are then 
addressed by the corresponding segment register. ASM-86 assigns statements to the 
specified segment until it encounters another segment directive. 
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Instruction statements must be assigned to the Code Segment. Directive statements 
may be assigned to any segment. ASM-86 uses these assignments to change from 
one segment register to another. For example, when an instruction accesses a 
memory variable, ASM-86 must know which segment contains the variable so it can 
generate a segment override prefix byte if necessary. 



The CSEG Directive 

CSEG <numeric expressiori> 

CSEG 

CSEG $ 

This directive tells the assembler that the following statements belong in the Code 
Segment. All instruction statements must be assigned to the Code Segment. All 
directive statements are legal within the Code Segment. 

Use the first form when the location of the segment is known at assembly time; the 
code generated is not relocatable. Use the second form when the segment location is 
not known at assembly time; the code generated is relocatable. Use the third form to 
continue the Code Segment after it has been interrupted by a DSEG, SSEG, or 
ESEG directive. The continuing Code Segment starts with the same attributes, such 
as location and instruction pointer, as the previous Code Segment. 



The DSEG Directive 

DSEG <numeric expressiori> 

DSEG 

DSEG $ 

This directive specifies that the following statements belong to the Data Segment. 
The Data Segment primarily contains the data allocation directives DB, DW, DD 
and RS, but all other directive statements are also legal. Instruction statements are 
illegal in the Data Segment. 

Use the first form when the location of the segment is known at assembly time; the 
code generated is not relocatable. Use the second form when the segment location is 
not known at assembly time; the code generated is relocatable. Use the third form to 
continue the Data Segment after it has been interrupted by a CSEG, SSEG, or 
ESEG directive. The continuing Data Segment starts with the same attributes as the 
previous Data Segment. 
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The SSEG Directive 

SSEG <numeric expression^ 

SSEG 

SSEG $ 

The SSEG directive indicates the beginning of source lines for the Stack Segment. 
Use the Stack Segment for all stack operations. All directive statements are legal in 
the Stack Segment, but instruction statements are illegal. 

Use the first form when the location of the segment is known at assembly time; the 
code generated is not relocatable. Use the second form when the segment location is 
not known at assembly time; the code generated is relocatable. Use the third form to 
continue the Stack Segment after it has been interrupted by a CSEG, DSEG, or 
ESEG directive. The continuing Stack Segment starts with the same attributes as 
the previous Stack Segment. 



The ESEG Directive 

ESEG <numeric expression^ 

ESEG 

ESEG $ 

This directive initiates the Extra Segment. All directive statements are legal in the 
Extra Segment, but instruction statements are illegal. 

Use the first form when the location of the segment is known at assembly time; the 
code generated is not relocatable. Use the second form when the segment location is 
not known at assembly time; the code generated is relocatable. Use the third form to 
continue the Extra Segment after it has been interrupted by a DSEG, SSEG, or 
CSEG directive. The continuing Extra Segment starts with the same attributes as 
the previous Extra Segment. 



THE ORG DIRECTIVE 

ORG <numeric expressiorO 

The ORG directive sets the offset of the location counter in the current segment to 
the value specified in the numeric expression. Define all elements of the expression 
before the ORG directive to avoid ambiguity in forward references. 
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In most segments, an ORG directive is unnecessary. If no ORG is included before 
the first instruction or data byte in a segment, assembly begins at location zero 
relative to the beginning of the segment. A segment can have any number of ORG 
directives. 

THE IF AND ENDIF DIRECTIVES 

IF <numeric expression^ 

<source line 1> 
<source line 2> 



<source line ri> 
ENDIF 

The IF and ENDIF directives allow a group of source lines to be conditionally 
included or excluded from the assembly. Use conditional directives to assemble 
several different versions of a single source program. 

When the assembler finds an IF directive, it evaluates the numeric expression 
following the IF keyword. If the expression evaluates to a nonzero value, then 
<source line 1> through <source line ri> are assembled. If the expression evaluates 
to zero, then the lines are not assembled. All elements in the numeric expression 
must be defined before they appear in the IF directive. IF directives can be nested to 
five levels. 

THE IFLIST AND NOIFLIST DIRECTIVES 

The IFLIST directive tells ASM-86 to list the lines in false IF blocks. This is the 
default condition. The NOIFLIST directive suppresses listing the lines when an IF 
directive evaluates to zero. 

THE INCLUDE DIRECTIVE 

INCLUDE <filename> 

This directive includes another ASM-86 file in the source text. For example, the 
directive: 

INCLUDE EQUALS.A86 

instructs the assembler to insert into the source text the file named EQUALS. A86. 
Use INCLUDE when the source program resides in several different files. 
INCLUDE directives may not be nested; a source file called by an INCLUDE 
directive may not contain another INCLUDE statement. If <filename> does not 
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contain a file type, the file type is assumed to be .A86. If no drive name is specified 
with <filename>, ASM-86 assumes the drive containing the source file. 

THE END DIRECTIVE 

END 

An END directive marks the end of a source file. Any subsequent lines are ignored 
by the assembler. END is optional. If not present, ASM-86 processes the source 
until it finds an end-of-file character (1AH). 



THE EQU DIRECTIVE 

symbol EQU <numeric expressiori> 

symbol EQU <address expression^ 

symbol EQU <jregistef> 

symbol EQU instruction mnemonic> 

The EQU (equate) directive assigns values and attributes to user-defined symbols. 
The required symbol name may not be terminated with a colon. The symbol cannot 
be redefined by a subsequent EQU or another directive. Any elements used in 
numeric or address expressions must be defined before the EQU directive appears. 

The first form assigns a numeric value to the symbol; the second assigns a memory 
address. The third form assigns a new name to an 8086 register. The fourth form 
defines a new instruction subset. The following are examples of these four forms: 



0005 


FIVE 


EQU 


2*2 + 1 


0033 


NEXT 


EQU 


BUFFER 


0001 


COUNTER 


EQU 


CX 




MOVVV 


EQU 


MOV 



005D 8BC3 MOVVV AX,BX 

An error is reported if an invalid numeric quantity appears in an EQU directive. 
Forward references in EQU directives are flagged as errors. 

THE DB DIRECTIVE 

{symbol} DB <numeric expression^ { , <numeric expression^ .. } 
{symbol} DB <string constanf> {<string constani> ... } 



3-5 



Assembler Directives 



The DB directive defines initialized storage areas in byte format. Numeric expres- 
sions are evaluated to 8-bit values and sequentially placed in the hex output file. 
String constants are placed in the output file according to the rules defined in 
Chapter 2. A DB directive is the only ASM-86 statement that accepts a string 
constant longer than two bytes. There is no translation from lowercase to uppercase 
within strings. Multiple expressions or constants, separated by commas, may be 
added to the definition, but may not exceed the physical line length. 

Use an optional symbol to reference the defined data area throughout the program. 
The symbol has four attributes: the Segment and Offset attributes determine the 
symbol's memory reference, the Type attribute specifies single bytes, and Length 
tells the number of bytes (allocation units) reserved. 

The following statements show DB directives with symbols: 

005F 43502F4D2073 TEXT DB 'CP/M system',0 

797374656D00 

006B El A A DB V.+ 80H 

006C 0102030405 X DB 1,2,3,4,5 



0071 B90C00 MOV CX, LENGTH TEXT 



THE DW DIRECTIVE 

{symbol} DW <numeric expressiorO { , <numeric expressiorO .. } 
{symbol} DW <string constanO { , <string constanO ... } 

The DW directive initializes two-byte words of storage. String constants longer 
than two characters are illegal. Otherwise, DW uses the same procedure to initialize 
storage as DB. The following are examples of DW statements: 



0074 


0000 


CNTR 


DW 





0076 


63C166C169C1 


JMPTAB 


DW 


SUBR1,SUBR2,SUBR3 


007C 


010002000300 
040005000600 




DW 


1,2,3,4,5,6 



THE DD DIRECTIVE 

{symbol} DD <numeric expressiorO { , <numeric expressiorO .. } 



3-6 



Assembler Directives 



The DD directive initializes four bytes of storage. The Offset attribute of the 
address expression is stored in the two lower bytes, the Segment attribute in the two 
upper bytes. Otherwise, DD follows the same procedure as DB. The following are 
examples of DD statements: 

1234 CSEG 1234H 



0000 


6CC134126FC1 LONG_JMPTAB 

3412 


DD 


ROUTl,ROUT2 


0008 


72C1341275C1 
3412 


DD 


ROUT3,ROUT4 



RS 


80 


RS 


4000H 


RS 


1 



THE RS DIRECTIVE 

{symbol} RS <numeric expression^ 

The RS directive allocates storage in memory but does not initialize it. The numeric 
expression gives the number of bytes to be reserved. An RS statement does not give 
a byte attribute to the optional symbol. The following example shows the RS 
statement: 

0010 BUF 

0060 

4060 



THE RB DIRECTIVE 

{symbol} RB <numeric expressiori> 

The RB directive allocates byte storage in memory without any initialization. This 
directive is identical to the RS directive except that it does give the byte attribute. 

THE RW DIRECTIVE 

{symbol} RW <numeric expressiori> 
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The RW directive allocates two-byte word storage in memory but does not initialize 
it. The numeric expression gives the number of words to be reserved. The following 
example shows the RW statement: 

4061 BUFF RW 128 

4161 RW 4000H 

C161 RW 1 



THE TITLE DIRECTIVE 

TITLE <string constani> 

ASM-86 prints the string constant defined by a TITLE directive statement at the top 
of each printout page in the listing file. The title character string should not exceed 
30 characters. The following example shows the TITLE statement: 

TITLE 'CP/M monitor' 



THE PAGESIZE DIRECTIVE 

PAGESIZE <numeric expressiori> 

The PAGESIZE directive defines the number of lines to be included on each 
printout page. The default page size is 66. 

THE PAGEWIDTH DIRECTIVE 

PAGEWIDTH <numeric expressiorO 

The PAGEWIDTH directive defines the number of columns printed across the 
page when the listing file is output. The default page width is 120 columns unless the 
listing is routed directly to the terminal; then the default page width is 79 columns. 

THE EJECT DIRECTIVE 

EJECT 

The EJECT directive performs a page eject during printout. The EJECT directive 
itself is printed on the first line of the next page. 
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THE SIMFORM DIRECTIVE 

SIMFORM 

The SIMFORM directive replaces a form feed (FF) character in the print file with 
the correct number of line feeds (LF). Use this directive when printing on a printer 
that is unable to interpret the form feed character. 



THE NOLIST AND LIST DIRECTIVE 

NOLIST 
LIST 

The NOLIST directive blocks the printout of lines following the directive. Restart 
the listing with a LIST directive. 
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INTRODUCTION 

The ASM-86 instruction set includes all 8086 machine instructions. The general 
syntax for instruction statements is given in Chapter 2. The following sections 
define the specific syntax and required operand types for each instruction, without 
reference to labels or comments. The instruction definitions are presentecj-in tables 
for easy reference. For a more detailed description of each instruction, see Intel's 
MCS-86 Assembly Language Reference Manual. For descriptions of the instruction 
bit patterns and operations, see Intel's MCS-86 User's Manual. 

The instruction definition tables present ASM-86 instruction statements as combi- 
nations of mnemonics and operands. A mnemonic is a symbolic representation for 
an instruction, and its operands are the required parameters. Instructions can take 
zero, one, or two operands. When two operands are specified, the left operand is the 
instruction's destination operand and the two operands are separated by a comma. 

The instruction definition tables organize ASM-86 instructions into functional 
groups. Within each table, the instructions are listed alphabetically. Table 4-1 
shows the symbols used in the instruction definition tables to define operand types. 

Table 4-1 Operand Type Symbols 



SYMBOL 


OPERAND TYPE 


numb 
numb8 

ace 
reg 


any NUMERIC expression 

any NUMERIC expression which evaluates to an 8-bit 
number 

accumulator register, AX or AL 

any general purpose register, not segment register 
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Table 4-1 Operand Type Symbols (cont'd) 



SYMBOL 


OPERAND TYPE 


regl6 


a 16-bit general purpose register, not segment register 


segreg 


any segment register: CS, DS, SS, or ES 


mem 


any ADDRESS expression, with or without base- 




and/or index-addressing modes, such as: 




variable 




variable+3 




variable[bx] 




variable[SI] 




variable[BX+SI] 




[BX] 




[BP+DI] 


simpmem 


any ADDRESS expression WITHOUT base- and 




index- addressing modes, such as: 




variable 




variable+4 


mem\reg 


any expression symbolized by "reg" or "mem" 


mem\regl6 


any expression symbolized by "mem reg", but must be 




16 bits 


label 


any ADDRESS expression which evaluates to a label 


lab8 


any "label" which is within ±128 bytes distance from 




the instruction 



The 8086 CPU has nine single-bit flag registers which reflect the state of the CPU. 
The user cannot access these registers directly, but can test them to determine the 
effects of an executed instruction on an operand or register. The effects of instruc- 
tions on flag registers are also described in the instruction definition tables, using 
the symbols shown in Table 4-2 to represent the nine flag registers. 



4-2 



The ASM-86 Instruction Set 



Table 4-2 Flag Register Symbols 



AF 


Auxiliary-Carry-Flag 


CF 


Carry-Flag 


DF 


Direction-Flag 


IF 


Interrupt-Enable-Flag 


OF 


Overflow-Flag 


PF 


Parity-Flag 


SF 


Sign-Flag 


TF 


Trap-Flag 


ZF 


Zero-Flag 



DATA TRANSFER INSTRUCTIONS 

There are four classes of data transfer operations: general purpose, accumulator 
specific, address-object and flag. Only SAHF and POPF affect flag settings. Note in 
Table 4-3 that if acc= AL, a byte is transferred, but if acc=AX, a word is transferred. 



Table 4-3 Data Transfer Instructions 





SYNTAX 


RESULT 


IN 
IN 
LAHF 


acc,numb8\numbl6 
acc,DX 


Transfer data from input port given by numb8 
or numbl6 (0-255) to accumulator. 

Transfer data from input port given by DX 
register (0-OFFFFH) to accumulator. 

Transfer flags to the AH register. 
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Table 4-3 Data Transfer Instructions (cont'd) 



SYNTAX 


RESULT 


LDS 


regl6, mem 


Transfer the segment part of the memory 
address (DWORD variable) to the DS seg- 
ment register, transfer the offset part to a 
general purpose 16-bit register. 


LEA 


r eg 16, mem 


Transfer the offset of the memory address to a 
(16-bit) register. 


LES 


regl6,mem 


Transfer the segment part of the memory 
address to the ES segment register, transfer 
the offset part to a 16-bit general purpose 
register. 


MOV 


reg,mem\reg 


Move memory or register to register. 


MOV 


mem\reg,reg 


Move register to memory or register. 


MOV 


mem\reg,numb 


Move immediate data to memory or register. 


MOV 


segreg, mem\ regl6 


Move memory or register to segment register. 


MOV 


mem\ regl6, segreg 


Move segment register to memory or register. 


OUT 


numb8\ numb 16, ace 


Transfer data from accumulator to output 
port (0-255) given by numb8 or numbl6. 


OUT 


DX,acc 


Transfer data from accumulator to output 
port (0-FFFFH) given by DX register. 


POP 


mem\ regl6 


Move top stack element to memory or register. 


POP 


segreg 


Move top stack element to segment register; 
note that CS segment register not allowed. 


POPF 




Transfer top stack element to flags. 
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Table 4-3 Data Transfer Instructions (cont'd) 



SYNTAX 


RESULT 


PUSH 


merrt[ regl6 


Move memory or register to top stack element. 


PUSH 


segreg 


Move segment register to top stack element. 


PUSHF 




Transfer flags to top stack element. 


SAHF 




Transfer the AH register to flags. 


XCHG 


reg,mem\reg 


Exchange register and memory or register. 


XCHG 


mem\reg,reg 


Exchange memory or register and register. 


XLAT 


mem\ reg 


Perform table lookup translation. The table is 
given by "mem reg", which is always BX. 
Replaces AL with AL offset from BX. 



ARITHMETIC, LOGICAL, AND SHIFT INSTRUCTIONS 

The 8086 CPU performs the four basic mathematical operations in several different 
ways. It supports both 8-bit and 16-bit operations as well as signed and unsigned 
arithmetic. 

Six of the nine flag bits are set or cleared by most arithmetic operations to reflect the 
result of the operation. Table 4-4 summarizes the effects of arithmetic instructions 
on flag bits. Table 4-5 defines arithmetic instructions. Table 4-6 defines logical and 
shift instructions. 



Table 4-4 Effects of Arithmetic Instructions on Flags 



FLAG 



EFFECT 



CF 



is set if the operation resulted in a carry out of (from addition) 
or a borrow into (from subtraction) the high-order bit of the 
result; otherwise CF is cleared. 



4-5 



The ASM'86 Instruction Set 



Table 4-4 Effects of Arithmetic Instructions on Flags (cont'd) 


FLAG 


EFFECT 


AF 


is set if the operation resulted in a carry out of (from addition) 
or a borrow into (from subtraction) the low-order four bits of 
the result; otherwise AF is cleared. 


ZF 


is set if the result of the operation is zero; otherwise ZF is 
cleared. 


SF 


is set if the result is negative. 


PF 


is set if the modulo 2 sum of the low-order eight bits of the 
result of the operation is (even parity); otherwise PF is 
cleared (odd parity). 


OF 


is set if the operation resulted in an overflow; the size of the 
result exceeded the capacity of its destination. 



Table 4-5 Arithmetic Instructions 



SYNTAX 


RESULT 


AAA 


Adjust unpacked BCD (ASCII) for addition - 
adjusts AL. 


AAD 


Adjust unpacked BCD(ASCII) for division - 
adjusts AL. 


AAM 


Adjust unpacked BCD (ASCII) for multiplication 
- adjusts AX. 


AAS 


Adjust unpacked BCD (ASCII) for subtraction 
-adjusts AL. 


ADC reg, mem\ reg 


Add (with carry) memory or register to register. 


ADC mem\ reg, reg 


Add (with carry) register to memory or register. 
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Table 4-5 Arithmetic Instructions (cont'd) 


SYNTAX 


RESULT 


ADC 


mem\reg,numb 


Add (with carry) immediate data to memory or 
register. 


ADD 


reg,mem\reg 


Add memory or register to register. 


ADD 


mem\reg,reg 


Add register to memory or register. 


ADD 


mem\reg,numb 


Add immediate data to memory or register. 


CBW 




Convert byte in AL to word in AH by sign exten- 
sion. 


CWD 




Convert word in AX to double word in DX/AX 
by sign extension. 


CMP 


reg,mem\reg 


Compare register with memory or register. 


CMP 


mem\reg,reg 


Compare memory or register with register. 


CMP 


mem\reg,numb 


Compare data constant with memory or register. 


DAA 
DAS 




Perform decimal adjustment for addition - 
adjusts AL. 

Perform decimal adjustment for subtraction - 
adjusts AL. 


DEC 


mem\reg 


Subtract 1 from memory or register. 


INC 


mem\reg 


Add 1 to memory or register. 


DIV 


mem\reg 


Divide (unsigned) accumulator (AX or AL) by 
memory or register. If byte results, AL = quo- 
tient, AH = remainder. If word results, AX = 
quotient, DX = remainder. 


IDIV 


mem\ reg 


Divide (signed) accumulator (AX or AL) by 
memory or register - quotient and remainder 
stored as in DIV. 
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Table 4-5 Arithmetic Instructions (cont'd) 



SYNTAX 


RESULT 


IMUL 


mem\ reg 


Multiply (signed) memory or register by accumu- 
lator (AX or AL) - if byte, results in AH, AL. If 
word, results in DX, AX, 


MUL 


mem\ reg 


Multiply (unsigned) memory or register by accu- 
mulator (AX or AL) - results stored as in IMUL. 


NEG 


mem\ reg 


Two's complement memory or register. 


SBB 


reg,ment\reg 


Subtract (with borrow) memory or register from 
register. 


SBB 


mem\reg,reg 


Subtract (with borrow) register from memory or 
register. 


SBB 


mem\reg,numb 


Subtract (with borrow) immediate data from 
memory or register. 


SUB 


reg,mem\reg 


Subtract memory or register from register. 


SUB 


mem\reg,reg 


Subtract register from memory or register. 


SUB 


mem\reg,numb 


Subtract data constant from memory or register. 



Table 4-6 Logic and Shift Instructions 



SYNTAX 


RESULT 


AND 


reg,mem\reg 


Perform bitwise logical "and" of a register and 
memory register. 


AND 


mem\reg,reg 


Perform bitwise logical "and" of memory register 
and register. 


AND 


\mem\reg,numb 


Perform bitwise logical "and" of memory register 
and data constant. 
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Table 4-6 Logic and Shift Instructions (cont'd) 



SYNTAX 


RESULT 


NOT 


mem\ reg 


Form ones complement of memory or register. 


OR 


reg,mem\reg 


Perform bitwise logical "or" of a register and 
memory register. 


OR 


mem\reg,reg 


Perform bitwise logical "or" of memory register 
and register. 


OR 


mem\reg,numb 


Perform bitwise logical "or" of memory register 
and data constant. 


RCL 


mem\reg,\ 


Rotate memory or register 1 bit left through carry 
flag. 


RCL 


mem\reg,CL 


Rotate memory or register left through carry flag, 
number of bits given by CL register. 


RCR 


mem\ reg, 1 


Rotate memory or register 1 bit right through 
carry flag. 


RCR 


mem\ reg, CL 


Rotate memory or register right through carry 
flag, number of bits given by CL register. 


ROL 


mem\ reg, 1 


Rotate memory or register 1 bit left. 


ROL 


mem\reg,CL 


Rotate memory or register left, number of bits 
given by CL register. 


ROR 


mem\ reg, 1 


Rotate memory or register 1 bit right. 


ROR 


mem\reg,CL 


Rotate memory or register right, number of bits 
given by CL register. 


SAL 


mem\ reg, 1 


Shift memory or register 1 bit left, shift in low- 
order zero bits. 
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Table 4-6 


Logic and Shift Instructions (cont'd) 


SYNTAX 


RESULT 


SAL 


mem\reg,CL 


Shift memory or register left, number of bits 
given by CL register, shift in low-order zero bits. 


SAR 


mem\reg,\ 


Shift memory or register 1 bit right, shift in high- 
order bits equal to the original high-order bit. 


SAR 


mem\reg,CL 


Shift memory or register right, number of bits 
given by CL register, shift in high-order bits equal 
to the original high-order bit. 


SHL 


mem\regl 


Shift memory or register 1 bit left, shift in low- 
order zero bits. Note that SHL is a different 
mnemonic for SAL. 


SHL 


mem\reg,CL 


Shift memory or register left, number of bits 
given by CL register, shift in low-order zero bits. 
Note that SHL is a different mnemonic for SAL. 


SHR 


mem\reg,\ 


Shift memory or register 1 bit right, shift in high- 
order zero bits. 


SHR 


mem\reg,CL 


Shift memory or register right, number of bits 
given by CL register, shift in high-order zero bits. 


TEST 


reg,merrj\reg 


Perform bitwise logical "and" of a register and 
memory or register. Set condition flags but do not 
change destination. 


TEST 


mem\reg,reg 


Perform bitwise logical "and" of memory register 
and register. Set condition flags but do not 
change destination. 


TEST 


mem\reg,numb 


Perform bitwise logical "and" test of memory reg- 
ister and data constant. Set condition flags but do 
not change destination. 
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Table 4-6 


Logic and Shift Instructions (cont'd) 


SYNTAX 


RESULT 


XOR 


reg,mem\reg 


Perform bitwise logical "exclusive or" of a register 
and memory or register. 


XOR 


mem\reg,reg 


Perform bitwise logical "exclusive or" of memory 
register and register. 


XOR 


mem\reg,numb 


Perform bitwise logical "exclusive or" of memory 
register and data constant. 



STRING INSTRUCTIONS 

String instructions take one or two operands. The operands specify only the 
operand type, determining whether the operation is on bytes or words. If there are 
two operands, the source operand is addressed by the SI register and the destination 
operand is addressed by the DI register. The DI and SI registers are always used for 
addressing. Note that for string operations, destination operands addressed by DI 
must always reside in the Extra Segment (ES). 
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Table 4-7 String Instructions 



SYNTAX 


RESULT 


CMPS 


mem\ reg, mem\ reg 


Compare byte or word of string. 


CMPSB 


mem\ reg, mem\ reg 


Compare string in byte form. 


CMPSW 


mem\ reg, mem\ reg 


Compare string in word form. 


LODS 


mem\ reg 


Transfer a byte or word from the 
source operand to the accumulator. 


LODSB 


mem\ reg 


Transfer in byte form. 


LODSW 


mem\ reg 


Transfer in word form. 


MOVS 


mem\ reg, mem\ reg 


Move 1 byte (or word) from source to 
destination. 


MOVSB 


mem\ reg, mem\ reg 


Move 1 byte. 


MOVSW 


mem\ reg, mem\ reg 


Move 1 word. 


SCAS 


mem\ reg 


Subtract destination operand from 
accumulator (AX or AL), affect flags, 
but do not return result. 


SCASB 


mem\ reg 


Subtract destination operand from 
accumulator in byte form. 


SCASW 


mem\ reg 


Subtract destination operand from 
accumulator in word form. 


STOS 


mem\ reg 


Transfer a byte or word from accumu- 
lator to the destination operand. 


STOSB 


mem\ reg 


Transfer from accumulator to the des- 
tination operand in byte form. 


STOSW 


mem\ reg 


Transfer from the accumulator to the 
destination operand in word form. 
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Table 4-8 defines prefixes for string instructions. A prefix repeats the string instruc- 
tion the number of times contained in the CX register, which is decremented by 1 for 
each iteration. Prefix mnemonics precede the string instruction mnemonic in the 
statement line as shown in Chapter 2. 



Table 4-8 Prefix Instructions 



SYNTAX 


RESULT 


REP 
REPZ 

REPE 

REPNZ 

REPNE 


Repeat until CX register is zero. 

Repeat until CX register is zero and zero flag (ZF) is not 
zero. 

Same as "REPZ" 

Repeat until CX register is zero and zero flag (ZF) is zero. 

Same as "REPNZ" 



CONTROL TRANSFER INSTRUCTIONS 

All of the following classes of control transfer instructions cause program execution 
to continue at some new location in memory, possibly in a new code segment. The 
transfer may be absolute or depend on a certain condition. 

• calls, jumps, and returns 

• conditional jumps 

• iterational control 

• interrupts 

Table 4-9 defines control transfer instructions. In the definitions of conditional 
jumps, above and below refer to the relationship between unsigned values, and 
greater than and less than refer to the relationship between signed values. 

Table 4-9 Control Transfer Instructions 



SYNTAX 


RESULT 


CALL i a b e i 


Push the offset address of the next instruction on 
the stack, jump to the target label. 
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Table 4-9 Control Transfer Instructions (cont'd) 



SYNTAX 


RESULT 


CALL 


mem\regl6 


Push the offset address of the next instruction on 
the stack, jump to location indicated by contents 
of specified memory or register. 


CALLF 


label 


Push CS segment register on the stack, push the 
offset address of the next instruction on the stack 
(after CS), jump to the target label. 


CALLF 


mem 


Push CS register on the stack, push the offset 
address of the next instruction on the stack, jump 
to location indicated by contents of specified 
double word in memory. 


INT 


numb8 


Push the flag registers (as in PUSHF), clear TF 
and IF flags, transfer control with an indirect call 
through any one of the 256 interrupt-vector ele- 
ments. This instruction uses three levels of stack. 


INTO 




If OF (the overflow flag) is set, push the flag 
registers (as in PUSHF), clear TF and IF flags, 
transfer control with an indirect call through 
interrupt-vector element 4 (location 10H). If the 
OF flag is cleared, no operation takes place. 


IRET 




Transfer control to the return address saved by a 
previous interrupt operation, restore saved flag 
registers, CS, and IP. This instruction pops three 
levels of stack. 


JA 


lab8 


Jump if "not below or equal" or "above" ((CF or 
ZF) = 0). 


JAE 


lab8 


Jump if "not below" or "above or equal" (CF = 0). 


JB 


labS 


Jump if "below" or "not above or equal" (CF = 1). 
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Table 4-9 Control Transfer Instructions (cont'd) 



SYNTAX 


RESULT 


JBE 


lab8 


Jump if "below or equal" or "not above" ((CF or 
ZF) = 1). 


JC 


lab8 


Same as "JB" 


JCXZ 


lab8 


Jump to target label if CX register is zero. 


JE 


lab8 


Jump if "equal" or "zero" (ZF = 1). 


JG 


lab8 


Jump if "not less or equal" or "greater" (((SF xor 
OF) or ZF) =0). 


JGE 


lab8 


Jump if "not less" or "greater or equal" ((SF xor 
OF) = 0). 


JL 


lab8 


Jump if "less" or "not greater or equal" ((SF xor 
OF) = 1). 


JLE 


lab8 


Jump if "less or equal" or "not greater" (((SF xor 
OF) or ZF) = 1). 


JMP 


label 


Jump to the target label. 


JMP 


mem\ regl6 


Jump to location indicated by contents of speci- 
fied memory or register. 


JMPF 


label 


Jump to the target label possibly in another code 
segment. 


JMPS 


lab8 


Jump to the target label within ±128 bytes from 
instruction. 


JNA 


lab8 


Same as "JBE" 


JNAE 


lab8 


Same as "JB" 
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Table 4-9 Control Transfer Instructions (cont'd) 




SYNTAX 


RESULT 


JNB 


labS 


Same as "JAE" 




JNBE 


lab8 


Same as "JA" 




JNC 


lab8 


Same as "JNB" 




JNE 


lab8 


Jump if "not equal" or "not zero" (ZF = 


= 0). 


JNG 


lab8 


Same as " JLE" 




JNGE 


lab8 


Same as "JL" 




JNL 


lab8 


Same as "JGE" 




JNLE 


lab8 


Same as "JG" 




JNO 


lab8 


Jump if "not overflow" (OF = 0). 




JNP 


lab8 


Jump if "not parity" or "parity odd". 




JNS 


lab8 


Jump if "not sign". 




JNZ 


lab8 


Same as "JNE" 




JO 


lab8 


Jump if "overflow" (OF = 1). 




JP 


lab8 


Jump if "parity" or "parity even" (PF = 


= 1). 


JPE 


lab8 


Same as "JP" 




JPO 


lab8 


Same as "JNP" 




JS 


lab8 


Jump if "sign" (SF = 1). 




JZ 


lab8 


Same as "JE" 
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Table 4-9 


Control Transfer Instructions (cont'd) 


SYNTAX 


RESULT 


LOOP 


lab8 


Decrement CX register by one, jump to target 
label if CX is not zero. 


LOOPE 


lab8 


Decrement CX register by one, jump to target 
label if CX is not zero and the ZF flag is set. 
"Loop while zero" or "loop while equal". 


LOOPNE 


lab8 


Decrement CX register by one, jump to target 
label if CX is not zero and ZF flag is cleared. 
"Loop while not zero" or "loop while not equal". 


LOOPNZ 


lab8 


Same as "LOOPNE" 


LOOPZ 


lab8 


Same as "LOOPE" 


RET 




Return to the return address pushed by a previous 
CALL instruction, increment stack pointer by 2. 


RET 


numb 


Return to the address pushed by a previous 
CALL, increment stack pointer by 2+numb. 


RETF 




Return to the address pushed by a previous 
CALLF instruction, increment stack pointer by 4. 


RETF 


numb 


Return to the address pushed by a previous 
CALLF instruction, increment stack pointer by 
4+numb. 



PROCESSOR CONTROL INSTRUCTIONS 

Processor control instructions manipulate the flag registers. Moreover, some of 
these instructions can synchronize the 8086 CPU with external hardware. 
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Table 4-10 Processor Control Instructions 



SYNTAX 


RESULT 


CLC 


Clear CF flag. 


CLD 


Clear DF flag, causing string instructions to 
auto-increment the operand points. 


CLI 


Clear IF flag, disabling maskable external inter- 
rupts. 


CMC 


Complement CF flag. 


ESC numb8, mem\ reg 


Do no operation other than compute the effective 
address and place it on the address bus (ESC is 
used by the 8087 numeric co-processor), numb8 
must be in the range 0-63. 


LOCK 


PREFIX instruction, cause the 8086 processor to 
assert the buslock signal for the duration of the 
operation caused by the following instruction. 
The LOCK prefix instruction may precede any 
other instruction. Buslock prevents co-processors 
from gaining the bus; this is useful for shared- 




resource semaphores. 


HLT 


Cause 8086 processor to enter halt state until an 
interrupt is recognized. 


STC 


Set CF flag. 


STD 


Set DF flag, causing string instructions to auto- 
decrement the operand pointers. 


STI 


Set IF flag, enabling maskable external interrupts. 


WAIT 


Cause the 8086 processor to enter a wait state if 
the signal on its "TEST" pin is not asserted. 
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INTRODUCTION TO CODEMACROS 

ASM-86 does not support traditional assembly language macros, but it does allow 
you to define your own instructions by using the CodeMacro Directive. Like 
traditional macros, codemacros are assembled wherever they appear in assembly 
language code, but there the similarity ends. Traditional macros contain assembly 
language instructions; a codemacro contains only codemacro directives. Macros 
are usually defined in the user's symbol table; ASM-86 codemacros are defined in 
the assembler's symbol table. A macro simplifies using the same block of instruc- 
tions over and over again throughout a program; a codemacro sends a bit stream to 
the output file and in effect adds a new instruction to the assembler. 

Because ASM-86 treats a codemacro as an instruction, you can invoke codemacros 
by using them as instructions in your program. The example below shows how 
MAC, an instruction defined by a codemacro, can be invoked. 



XCHG BX,WO RD3 

MAC PAR1,PAR2 

MUL AX,WORD4 



Note that MAC accepts two operands. When MAC was defined, these two oper- 
ands were also classified as to type, size, and so on by defining MAC's formal 
parameters. The names of the formal parameters, however, are not fixed. They 
merely indicate where and how the actual operands are to be used. The actual names 
or values of operands are supplied when the codemacro is invoked. 
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The definition of a codemacro starts with a line specifying its name and its formal 
parameters, if any. 

CodeMacro <name> {<formal parameter list>} 

The optional <formal parameter list> is defined as follows: 

<formal name>\<specifier lettef>{<modifier letter>{<range>} 

As stated above, the formal name is not fixed, but merely acts as a place holder. If a 
formal parameter list is present, the specifier letter is required and the modifier 
letter is optional. The following are possible specifier letters: 

A, C, D, E, M, R, S, X 

The following are possible modifier letters: 

b, d, w, sb 

The assembler ignores case except within strings, but for clarity, this section shows 
specifiers in uppercase and modifiers in lowercase. The following sections describe 
specifiers, modifiers, and the optional range in detail. 

The body of the codemacro describes the bit pattern and formal parameters. Only 
the following directives are legal within codemacros: 

SEGFIX 

NOSEGFIX 

MODRM 

RELB 

RELW 

DB 

DW 

DD 

DBIT 

These directives are unique to codemacros, and those which appear to duplicate 
ASM-86 directives (DB, DW, and DD) have different meanings in codemacro 
context. These directives are discussed in detail in later sections. The definition of 
each codemacro ends with the line: 

EndM 
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CodeMacro, EndM, and the codemacro directives are all reserved words. 
Codemacro definition syntax is defined in Backus-Naur-like form in Appendix H. 

The following examples are typical codemacro definitions. 

CodeMacro AAA 

DB37H 
EndM 

CodeMacro DIV divisonEb 

SEGFIX divisor 

DB 6FH 

MODRM divisor 
EndM 

CodeMacro ESC opcode:Db(0,63),src:Eb 

SEGFIX src 

DBIT 5 (lBH),3(opcode(3)) 

MODRM opcode, src 
EndM 



SPECIFIERS 

Every formal parameter must have a specifier letter that indicates what type of 
operand is needed to match the formal parameter. Table 5-1 defines the eight 
possible specifier letters. 





Table 5-1 Codemacro Operand Specifiers 


LETTER 


OPERAND TYPE 


A 


Accumulator register, AX or AL. 


C 


Code, a label expression only. 


D 


Data, a number to be used as an immediate value. 


E 


Effective address, either an M (memory address) or an R 
(register). 
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Table 5-1 Codemacro Operand Specifiers (cont'd) 



LETTER 


OPERAND TYPE 


M 

R 
S 
X 


Memory address. This can be either a variable or a brack- 
eted register expression. 

A general register only. 

Segment register only. 

A direct memory reference. 



MODIFIERS 

The optional modifier letter is a further requirement on the operand. The meaning 
of the modifier letter depends on the type of the operand. For variables, the 
following modifiers are used depending on the operand: "6" for byte, "w" for word, 
"*f 'for double-word and ' W for signed byte. For numbers, the modifier depends 
on the size of the number: "6" for -256 to 255 and "w" for other numbers. Table 5-2 
summarizes codemacro modifiers. 

Table 5-2 Codemacro Operand Modifiers 



VARIABLES 


NUMBERS 


Modifier 


Type 


Modifier 


Size 


b 
w 
d 
sb 


byte 

word 

dword 

signed 

byte 


b 

w 


-256 to 255 

Any other number 



RANGE SPECIFIERS 

The optional range is specified within parentheses by either one expression or two 
expressions separated by a comma. The following are valid formats: 
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(numberb) 
(register) 

(numberb,numberb) 
(numberb,register) 
(register, numberb) 
(register, register) 

where numberb is an 8-bit number, not an address. The following example specifies 
that the input port must be identified by the DX register: 

CodeMacro IN dst:Aw,port:Rw(DX) 

The next example specifies that the CL register is to contain the "count" of rotation: 

CodeMacro ROR dst:Ew,count:Rb(CL) 

The next example specifies that the "opcode" is to be immediate data, and may range 
from to 63 inclusive: 

CodeMacro ESC opcode:Db(0,63),adds:Eb 

CODEMACRO DIRECTIVES 

Codemacro directives define the bit pattern as well as make further requirements on 
how the operand is to be treated. Directives are reserved words, and those that 
appear to duplicate assembly language instructions have different meanings within 
a codemacro definition. Only the nine directives defined here are legal within 
codemacro definitions. 

SEGFIX 

If SEGFIX is present, it instructs the assembler to determine whether a segment- 
override prefix byte is needed to access a given memory location. If so, the segment- 
override prefix is output as the first byte of the instruction. If not, no action is taken. 
SEGFIX takes the form: 

SEGFIX <formal name> 

where <formal name> is the name of a formal parameter which represents the 
memory address. Because it represents a memory address, the formal parameter 
must have one of the specifiers E, M, or X. 
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NOSEGFIX 



Use NOSEGFIX for operands in instructions that must use the ES register for that 
operand. This applies only to the destination operand of these instructions: CMPS, 
MOVS, SCAS, STOS. The following is the form of NOSEGFIX: 

NOSEGFIX segreg, <form name> 

where segreg is one of the segment registers ES, CS, SS, or DS and <form name> is 
the name of the memory-address formal parameter, which must have a specifier E, 
M, or X. No code is generated from this directive, but an error check is performed. 
The following is an example of the use of NOSEGFIX: 

CodeMacro MOVS si_ptr:Ew,di_ptr:Ew 

NOSEGFIX ES,di_ptr 

SEGFIX sLptr 

DB 0A5H 

EndM 

MODRM 

This directive instructs the assembler to generate the ModRM byte, which follows 
the opcode byte in many of the 8086's instructions. The ModRM byte contains 
either the indexing type or the register number to be used in the instruction. It also 
specifies which register is to be used, or gives more information to specify an 
instruction. 

The ModRM byte carries the information in three fields. The mod field occupies the 
two most significant bits of the byte, and combines with the register memory field to 
form 32 possible values: 8 registers and 24 indexing modes. 

The reg field occupies the three next bits following the mod field. It specifies either a 
register number or three more bits of opcode information. The meaning of the reg 
field is determined by the opcode byte. 

The register memory field occupies the last three bits of the byte. It specifies a 
register as the location of an operand, or forms a part of the address-mode in 
combination with the mod field described above. 

For further information of the 8086's instructions and their bit patterns, see Intel's 
8086 Assembly Language Programing Manual and the Intel 8086 Family User's 
Manual. 
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The following forms of MODRM are used: 

MODRM <form name>,<form name> 
MODRM NUMBER7, <form name> 

where NUMBER7 is a value to 7 inclusive and <form name> is the name of a 
formal parameter. 

The following examples show the use of MODRM: 

CodeMacro RCR dst:Ew,count:Rb(CL) 

SEGFIX dst 

DB 0D3H 

MODRM 3,dst 
EndM 

CodeMacro OR dst:Rw,src:Ew 

SEGFIX src 

DB OBH 

MODRM dst,src 
EndM 



RELB and REL W 

These directives, used in IP-relative branch instructions, instruct the assembler to 
generate displacement between the end of the instruction and the label that is 
supplied as an operand. RELB generates one byte and RELW two bytes of dis- 
placement. The directives take the following forms: 

RELB <form name> 
RELW <form name> 

where <form name> is the name of a formal parameter with a "C" (code) specifier. 
For example: 

CodeMacro LOOP place:Cb 

DB 0E2H 

RELB place 
EndM 
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DB, DW and DD 

These directives differ from those which occur outside of codemacros. Use the 
following forms of these directives: 

DB <form name> | NUMBERB 
DW <form name>\ NUMBERW 
DD <form name> 

where NUMBERB is a single-byte number, NUMBERW is a two-byte number, and 
form name is a name of a formal parameter. For example: 

CodeMacro XOR dst:Ew,src:Db 

SEGFIX dst 

DB 81H 

MODRM 6,dst 

DW src 

EndM 



DBIT 

This directive manipulates bits in combinations of a byte or less. The directive takes 
the following form: 

DBIT <field descriptiori>{,<field description^ 
where & field description has two forms: 



<numberX.combinatiori> 
<numbef>{<form name>{<rshiff>)) 



where number ranges from 1 to 16 and specifies the number of bits to be set. The 
combination parameter specifies the desired bit combination. The total of all the 
numbers listed in the field descriptions must not exceed 16. The second form shown 
above contains/orw name, a. formal parameter name that instructs the assembler to 
put a certain number in the specified position. This number normally refers to the 
register specified in the first line of the codemacro. The numbers used in this special 
case for each register follow. 
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Codemacro Facilities 



AL: 





CL: 


1 


DL: 


2 


BL: 


3 


AH: 


4 


CH: 


5 


DH: 


6 


BH: 


7 


AX: 





CX: 


1 


DX: 


2 


BX: 


3 


SP: 


4 


BP: 


5 


SI: 


6 


DI: 


7 


ES: 





CS: 


1 


SS: 


2 


DS: 


3 



The parameter rjAi/f, which is contained in the innermost parentheses, specifies a 
number of right shifts. For example, "0" specifies no shift, "1" shifts right one bit, "2" 
shifts right two bits, and so on. The definition below uses this form. 

CodeMacro DEC dst:Rw 

DBIT 5(9H),3(dst(0)) 
EndM 

The first five bits of the byte have the value 9H. If the remaining bits are zero, the 
hex value of the byte will be 48H. If the following instruction is assembled: 

DEC DX 

and DX has a value of 2H, then 48H + 2H = 4AH, which is the final value of the byte 
for execution. If this sequence had been present in the definition: 

DBIT5(9H),3(dst(l)) 

then the register number would have been shifted right once and the result would 
had been 48H + 1H = 49H, which is erroneous. 
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Chapter 6 

DDT-86 

DDT-86 OPERATION 

The DDT-86 program allows the user to test and debug programs interactively in a 
CP/M-86 environment. To use DDT-86, you should be familiar with the 8086 
processor, ASM-86, and the CP/M-86 operating system as described in the CP/M- 
86 System Reference Guide for the APC. 

Invoking DDT86 

Invoke DDT-86 by entering one of the following commands. 

DDT86 
DDT&6 filespec 

The first command loads and executes DDT-86. After displaying its sign-on mes- 
sage and prompt character (-), DDT-86 is ready to accept operator commands. The 
second command is similar to the first, except that after DDT-86 is loaded, the file 
specified by filespec is also loaded. If the filetype is omitted from the filespec, 
".CMD" is assumed. Note that DDT-86 cannot load a file with a filetype of .H86. 

The second form of the invoking command is equivalent to the following sequence. 

A>DDT86 
DDT86 x.x 

"Efilename 

At this point, the loaded program is ready for execution. 
DDT-86 Command Conventions 

When DDT-86 is ready to accept a command, it displays a hyphen (-) as the prompt. 
In response, you can enter a command line or press CTRL-C to end the debugging 
session. A command line can have up to 64 characters, and is terminated when you 
press RETURN. When entering the command, use standard CP/M-86 line-editing 
functions (CTRL^X, CTRL-H, CTRL-R, and so forth) to correct typing errors. 
DDT-86 does not process the command line until RETURN is pressed. 
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The first character of each command line determines the command action. Table 
6- 1 summarizes the DDT-86 commands, which are defined individually later in the 
chapter. 

Table 6-1 DDT-86 Command Summary 



COMMAND 


ACTION 


A 


Enter assembly language statements. 


D 


Display memory in hexadecimal and ASCII. 


E 


Load program for execution. 


F 


Fill memory block with a constant. 


G 


Begin execution with optional breakpoints. 


H 


Perform hexadecimal arithmetic. 


I 


Set up file control block and command tail. 


L 


List memory using 8086 mnemonics. 


M 


Move memory block. 


R 


Read disk file into memory. 


S 


Set memory to new values. 


T 


Trace program execution. 


U 


Perform untraced program monitoring. 


V 


Show memory layout of disk file read. 


w 


Write contents of memory block to disk. 


X 


\ 

Examine and modify CPU state. 
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The command character can be followed by one or more arguments, consisting of 
hexadecimal values, file names, or other information, depending on the command. 
Arguments are separated from each other by commas or spaces. No spaces are 
allowed between the command character and the first argument. 

Specifying a 20-Bit Address 

Most DDT-86 commands require one or more addresses as operands. Because the 
8086 can address up to one megabyte of memory, addresses must be 20-bit values. 
Enter a 20-bit address as follows: 

ssss:oooo 

where ssss represents an optional 16-bit segment number and oooo is a 16-bit offset. 
DDT-86 combines these values to produce a 20-bit effective address as follows: 

ssssO 

+ 0000 

eeeee 

The optional value ssss may be a 16-bit hexadecimal value or the name of a segment 
register. If you specify a segment register name, the value of ssss represents the 
contents of that register in the user's CPU state, as indicated by the X command. If 
omitted, a default value appropriate to the command being executed is used, as 
described later in this chapter. 

Terminating DDT-86 

Terminate DDT-86 by pressing CTRL: C m response to the hyphen prompt. This 
returns control to the CCP. Note that CP/M-86 does not have the SAVE facility 
found in CP/M for 8-bit machines. Therefore, when using DDT-86 to patch a file, 
write the file to disk with the W command before exiting DDT-86. 

DDT-86 OPERATION WITH INTERRUPTS 

DDT-86 operates with interrupts disabled while a single instruction is being traced. 
It preserves the interrupt state of the program being executed under DDT-86. When 
DDT-86 has control of the CPU (either when it is initially invoked or when it 
regains control from the program being tested), the condition of the interrupt flag is 
the same as it was when DDT-86 was invoked. While the program being tested has 
control of the CPU, the user's CPU state, which can be displayed with the X 
command, determines the state of the interrupt flag. 
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DDT-86 COMMANDS 

This section defines DDT-86 commands and their arguments. DDT-86 commands 
give you control of program execution and allow you to display and modify system 
memory and the CPU state. 

The A (Assemble) Command 

The A command assembles 8086 mnemonics directly into memory. The following is 
the form of the A command: 



As 

where s is the 20-bit address where assembly is to start. DDT-86 responds to the A 
command by displaying the address of the memory location where assembly is to 
begin. At this point, enter assembly language statements as described in the 
Assembly Language Syntax section later in this chapter. When you enter a 
statement, DDT-86 converts it to binary, places the value(s) in memory, and 
displays the address of the next available memory location. This process continues 
until you enter a blank line or a line containing only a period. 



DDT-86 responds to invalid statements by displaying a question mark (?) and 
redisplaying the current assembly address. 



The D (Display) Command 

The D command displays the contents of memory as 8-bit or 16-bit hexadecimal 
values in ASCII. The following are the forms of the D command: 

D 

Ds 

Dj/ 

DW 

DWs 

DWj,/ 

where s is the 20-bit address where the display is to start, and /is the 16-bit offset 
within the segment specified by s where the display is to finish. 
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Memory is displayed on one or more display lines. Each display line shows the 
values of up to 16 memory locations. For the first three forms, the display line 
appears as follows: 

ssss:oooo bb bb . . . bb cc . . .c 

where ssss is the segment being displayed and oooo is the offset within segment ssss. 
The bb's represent the contents of the memory locations in hexadecimal, and the c's 
represent the contents of memory in ASCII. Any nongraphic ASCII characters are 
represented by periods. 

In response to the first form shown above, DDT-86 displays memory from the 
current display address for 12 display lines. The response to the second form is 
similar to the first, except that the display address is first set to the 20-bit address s. 
The third form displays the memory block between locations s and/. The next three 
forms are analogous to the first three, except that the contents of memory are 
displayed as 16-bit values, rather than 8-bit values, as shown below. 

ssss:oooo wwww wwww . . . wwww cccc . . .cc 

During a long display, you can abort the D command by typing any character at the 
console. 



The E (Load for Execution) Command 

The E command loads a file into memory so that a subsequent G, T or U command 
can begin program execution. The E command takes the form: 

^filename 

where filename is the name of the file to be loaded. If no filetype is specified, ".CMD" 
is assumed. The contents of the user segment registers and IP register are altered 
according to the information in the header of the file loaded. 

An E command releases all blocks of memory allocated by any previous E or R 
commands or by programs executed under DDT-86. Therefore, only one file at a 
time may be loaded for execution. 

When the load is complete, DDT-86 displays the starting and ending addresses of 
each segment in the file loaded. Use the V command to redisplay this information at 
a later time. 
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If the file does not exist or cannot be successfully loaded in the available memory, 
DDT-86 issues an error message. 



The F (Fill) Command 

The F command fills an area of memory with a byte or word constant. The 
following are the forms of the F command: 

Fs,f,b 
FWs,f,w 

where s is a 20-bit starting address of the block to be filled, and/is a 16-bit offset of 
the final byte of the block within the segment specified in s. 

In response to the first form, DDT-86 stores the 8-bit value b in locations s through 
/. In the second form, the 16-bit value w is stored in locations s through/in standard 
form, low 8 bits first followed by high 8 bits. 

If s is greater than/or if the value b is greater than 255, DDT-86 responds with a 
question mark. DDT-86 issues an error message if the value stored in memory 
cannot be read back successfully, indicating faulty or nonexistent RAM at the 
location indicated. 

The G (Go) Command 

The G command transfers control to the program being tested, and optionally sets 
one or two breakpoints. The following are the forms of the G command: 

G 

G,bl 

G,bl,b2 

Gs 

Gs,bl 

Gs,bl,b2 

where s is a 20-bit address where program execution is to start, and bl and b2 are 
20-bit breakpoint addresses. If no segment value is supplied for any of these three 
addresses, the segment value defaults to the contents of the CS register. 

In the first three forms, no starting address is specified; instead, DDT-86 derives the 
20-bit address from the CS and IP registers. The first form transfers control to the 
program being tested without setting any breakpoints. The next two forms respec- 



6-6 



DDT-i 



tively set one and two breakpoints before passing control to the user's program. The 
next three forms are analogous to the first three, except that the CS and IP registers 
are first set to s. 

Once control has been transferred to the program under test, it executes in realtime 
until a breakpoint is encountered. At this point, DDT-86 regains control, clears all 
breakpoints, and indicates the address at which execution of the program under test 
was interrupted as follows: 

*ssss:oooo 

where ssss corresponds to the CS and oooo corresponds to the IP where the break 
occurred. When a breakpoint returns control to DDT-86, the instruction at the 
breakpoint address has not yet been executed. 

The H (Hexadecimal Math) Command 

The H command computes the sum and difference of two 16-bit values. The 
following is the form of the H command: 

Ha,b 

where a and b are the values whose sum and difference are to be computed. DDT-86 
displays the sum (ssss) and the difference (dddd) truncated to 16 bits on the next line 
as shown below: 

ssss dddd 

The I (Input Command Tail) Command 

The I command prepares a file control block and command tail buffer in DDT-86's 
base page, and copies this information into the base page of the last file loaded with 
the E command. The following is the form of the I command: 

Icommandtail 

where the commandtail parameter is a character string that usually contains one or 
more filenames. The first filename is parsed into the default file control block at 
005CH. The optional second filename (if specified) is parsed into the second part of 
the default file control block beginning at 006CH. The characters in the command- 
tail parameter are also copied into the default command buffer at 0080H. The 
length of commandtail is stored at 0080H, followed by the character string 
terminated with a binary zero. 
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If a file has been loaded with the E command, DDT-86 copies the file control block 
and command buffer from the base page of DDT-86 to the base page of the program 
loaded. The location of DDT- 86's base page can be obtained from the SS register in 
the user's CPU state when DDT-86 is invoked. The location of the base page of a 
program loaded with the E command is the value displayed for DS upon comple- 
tion of the program load. 



The L (List) Command 

The L command lists the contents of memory in assembly language. The following 
forms of the L command are used: 

L 
Ls 

U/ 

where s is the 20-bit address at which the list is to start, and/is a 16-bit offset within 
the segment specified in s where the list is to finish. 

The first form lists twelve lines of disassembled machine code from the current list 
address. The second form sets the list address to s, then lists twelve lines of code. The 
last form lists disassembled code from s through/. In all three cases, the list address 
is set to the next unlisted location in preparation for a subsequent L command. 
When DDT-86 regains control from a program being tested (see G, T and U 
commands), the list address is set to the current value of the CS and IP registers. 

To abort long displays, press any key during the list process. Press CTRL-S to halt 
the display temporarily. 

The syntax of the assembly language statements produced by the L command is 
described later in the chapter. 



The M (Move) Command 

The M command moves a block of data values from one area of memory to another. 
The following is the form of the M command: 

Ms,f,d 

where s is the 20-bit starting address of the block to be moved,/is the offset of the 
final byte to be moved within the segment described by s, and dis the 20-bit address 
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of the first byte of the area to receive the data. If the segment is not specified in d, the 
value equals that used for s. Note that if the value of dis between s and/, part of the 
block being moved will be overwritten before it is moved, because data is 
transferred starting from location s. 



The R (Read) Command 

The R command reads a file into a contiguous block of memory. The following is 
the form of the R command: 

Rfilename 

where filename is the name and type of the file to be read. 

DDT-86 reads the file into memory and displays the starting and ending addresses 
of the block of memory occupied by the file. Note that a V command can redisplay 
this information at a later time. The default display pointer (for subsequent D 
commands) is set to the start of the block occupied by the file. 

The R command does not free any memory previously allocated by another R or E 
command. Therefore, a number of files can be read into memory without overlap- 
ping. The number of files that can be loaded is limited to seven, which is the number 
of memory allocations allowed by the BDOS, minus one for DDT-86 itself. 

If the file does not exist or there is not enough memory to load the file, DDT-86 
issues an error message. 

The S (Set) Command 

The S command can change the contents of bytes or words of memory. The 
following forms of the S command are used: 

SW5 

where s is the 20-bit address at which the change is to occur. 

DDT-86 displays the memory address and its current contents on the following line. 
In response to the first form, the display appears as follows: 

ssss:oooo bb 
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In response to the second form, the display appears as follows: 

ssss:oooo wwww 

In the above examples, bb and wwww are the contents of memory in byte and word 
formats, respectively. 

In response to one of the above displays, you can choose to alter the memory 
location or to leave it unchanged. If you enter a valid hexadecimal value, the 
contents of the byte (or word) in memory is replaced with the value. If no value is 
entered, the contents of memory are unaffected and the contents of the next address 
are displayed. In either case, DDT-86 continues to display successive memory 
addresses and values until either a period or an invalid value is entered. 

DDT-86 issues an error message if the value stored in memory cannot be read back 
successfully, indicating faulty or nonexistent RAM at the location indicated. 

The T (Trace) Command 

The T command traces program execution for 1 to OFFFFH program steps. The 
following forms of the T command are used: 

T 
T« 
TS 
TS« 

where n is the number of instructions to execute before returning control to the 
console. 

Before an instruction is executed, DDT-86 displays the current CPU state and the 
disassembled instruction. In the first two forms, the segment registers are not 
displayed, allowing the entire CPU state to be displayed on one line. The next two 
forms are analogous to the first two, except that all the registers are displayed, 
forcing the disassembled instruction to be displayed on the next line, as in the X 
command. 

In all of the forms, control transfers to the program under test at the address 
indicated by the CS and IP registers. If n is not specified, one instruction is executed. 
Otherwise DDT-86 executes n instructions, displaying the CPU state before each 
step. To abort a long trace before n steps have been executed, press any key. 
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After a T command, the list address used in the L command is set to tiie address of 
the next instruction to be executed. 

Note that DDT-86 does not trace through a BDOS interrupt instruction, since 
DDT-86 itself makes BDOS calls and the BDOS is not reentrant. Instead, the entire 
sequence of instructions from the BDOS interrupt through the return from BDOS is 
treated as one traced instruction. 

The U (Untrace) Command 

The U command is identical to the T command except that the CPU state is 
displayed only before the first instruction is executed, rather than before every step. 
The following forms of the U command are used: 



U 
U« 
US 
US« 

where n is the number of instructions to execute before returning control to the 
console. To abort the U command before n steps have been executed, press any key. 

The V (Value) Command 

The V command displays information about the last file loaded with the E or R 
commands. The following is the form of the V command: 



If the last file was loaded with the E command, the V command displays the starting 
and ending addresses of each of the segments contained in the file. If the last file was 
read with the R command, the V command displays the starting and ending 
addresses of the block of memory where the file was read. If neither the R nor E 
commands have been used, DDT-86 responds to the V command with a question 
mark (?). 

The W (Write) Command 

The W command writes the contents of a contiguous block of memory to disk. The 
following forms of the W command are used: 

^filename 
W 7 filename, s,f 
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where filename is the filename and filetype of the disk file to receive the data, and s 
and/are the 20-bit first and last addresses of the block to be written. If the segment 
is not specified in/, DDT-86 uses the same value used for s. 

If the first form is used, DDT-86 assumes the s and/values from the last file read 
with an R command. If no file was read with an R command, DDT-86 responds 
with a question mark (?). This form is useful for writing out files after patches have 
been installed, assuming the overall length of the file is unchanged. 

In the second form, where s and/are specified as 20-bit addresses, the low four bits 
of s are assumed to be 0. Thus the block being written must always start on a 
paragraph boundary. 

If the file with the name specified in the W command already exists, DDT-86 deletes 
it before writing a new file. 



The X (Examine CPU State) Command 

The X command allows the operator to examine and alter the CPU state of the 
program under test. The following forms of the X command are used: 

X 

Xr 
Xf 

where r is the name of one of the 8086 CPU registers and/is the abbreviation of one 
of the CPU flags. The first form displays the CPU state in the format: 

AX BX CX . . . SS ES IP 
xxxx xxxx xxxx . . . xxxx xxxx xxxx 



<instructiori> 

The nine hyphens at the beginning of the line indicate the state of the nine CPU 
flags. Each position can be either a hyphen, indicating that the corresponding flag is 
not set (0), or a one-character abbreviation of the flag name, indicating that the flag 
is set (1). The abbreviations of the flag names are shown in Table 6-2. The value for 
instruction is the disassembled instruction at the next location to be executed, 
indicated by the CS and IP registers. 
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Table 6-2 Flag Name Abbreviations 



CHARACTER 


NAME 


O 


Overflow 


D 


Direction 


I 


Interrupt Enable 


T 


Trap 


S 


Sign 


z 


Zero 


A 


Auxiliary Carry 


P 


Parity 


C 


Carry 



The second form allows you to alter the registers in the CPU state of the program 
being tested. The r following the X is the name of one of the 16-bit CPU registers. 
DDT-86 responds by displaying the name of the register followed by its current 
value. If RETURN is pressed, the value of the register is not changed. If a valid value 
is typed, the contents of the register are changed to that value. In either case, the 
next register is then displayed. This process continues until a period or an invalid 
value is entered, or the last register is displayed. 

The third form allows you to alter one of the flags in the CPU state of the program 
being tested. DDT-86 responds by displaying the name of the flag followed by its 
current state. If RETURN is pressed, the state of the flag is not changed. If a valid 
value is typed, the state of the flag is changed to that value. Only one flag may be 
examined or altered with each X/command. Set or reset flags by entering a value of 
1 orO. 

DEFAULT SEGMENT VALUES 

DDT-86 has an internal mechanism that keeps track of the current segment value, 
making segment specification an optional part of a DDT-86 command. DDT-86 
divides the command set into two types of commands, according to which segment 
a command defaults to if no segment value is specified in the command line. 

The first type of command pertains to the code segment: A (Assemble), L (List 
Mnemonics) and W (Write). These commands use the internal type-1 segment value 
if no segment value is specified in the command. 
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When invoked, DDT-86 sets the type-1 segment to 0, and changes it when one of the 
following actions is taken. 

• When a file is loaded by an E command, DDT-86 sets the type-1 segment 
value to the value of the CS register. 

• When a file is read-by an R command, DDT-86 sets the type-1 segment 
value to the base segment where the file was read. 

• When an X command changes the value of the CS register, DDT-86 changes 
the type-1 segment value to the new value of the CS register. 

• When DDT-86 regains control from a user program after a G, T or U 
command, it sets the type-1 segment value to the value of the CS register. 

• When a segment value is specified explicitly in an A or L command, 
DDT-86 sets the type-1 segment value to the segment value specified. 

The second type of command pertains to the data segment: D (Display), F (Fill), M 
(Move) and S (Set). These commands use the internal type-2 segment value if no 
segment value is specified in the command. 

When invoked, DDT-86 sets the type-2 segment value to 0, and changes it when one 
of the following actions is taken. 

• When a file is loaded by an E command, DDT-86 sets the type-2 segment 
value to the value of the DS register. 

• When a file is read by an R command, DDT-86 sets the type-2 segment value 
to the base segment where the file was read. 

• When an X command changes the value of the DS register, DDT-86 
changes the type-2 segment value to the new value of the DS register. 

• When DDT-86 regains control from a user program after a G, T or U 
command, it sets the type-2 segment value to the value of the DS register. 

• When a segment value is specified explicitly in a D, F, M or S command, 
DDT-86 sets the type-2 segment value to the segment value specified. 

When evaluating programs that use identical values in the CS and DS registers, all 
DDT-86 commands default to the same segment value unless explicitly overridden. 

Note that the G (Go) command does not fall into either group, since it defaults to 
the CS register. 
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Table 6-3 summarizes DDT-86's default segment values. 



Table 6-3 DDT-86 Default Segment 


Values 


COMMAND 


TYPE-1 


TYPE-2 


A 


X 




D 




X 


E 


c 


c 


F 




X 


G 


c 


c 


H 






I 






L 


X 




M 




X 


R 


c 


c 


S 




X 


T 


c 


c. 


U 


c 


c 


V 






W 


X 




X 


c 


c 


x - use this segment default if none specified; 


change default if specified explicitly 


c -change this segment default 



ASSEMBLY LANGUAGE SYNTAX FOR A AND L COMMANDS 

In general, the syntax of the assembly language statements used in the A and L 
commands is standard 8086 assembly language. Several minor exceptions are listed 
below. 

• DDT-86 assumes that all numeric values entered are hexadecimal. 

• Up to three prefixes (LOCK, repeat, segment override) may appear in one 
statement, but they all must precede the opcode of the statement. Alter- 
nately, a prefix may be entered on a line by itself. 
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The distinction between byte and word string instructions is made as 
follows: 



byte 


word 


LODSB 


LODSW 


STOSB 


STOSW 


SCASB 


SCASW 


MOVSB 


MOVSW 


CMPSB 


CMPSW 



The mnemonics for near and far control transfer instructions are as follows: 



short 


normal 


far 


JMPS 


JMP 


JMPF 




CALL 


CALLF 




RET 


RETF 



• If the operand of a CALLF or JMPF instruction is a 20-bit absolute 
address, it is entered in the following form: 

ssss.oooo 

where ssss is the segment and oooo is the offset of the address. 

• Operands that could refer to either a byte or word are ambiguous, and must 
be preceded either by the prefix BYTE or WORD. These prefixes may be 
abbreviated to BY and WO. For example: 

INC BYTE [BP] 

NOT WORD [1234] 

Failure to supply a prefix when needed results in an error message. 

• Operands which address memory directly are enclosed in square brackets to 
distinguish them from immediate values. For example: 

ADD AX,5 ;add 5 to register AX 

ADD AX,[5] ;add the contents of location 5 to AX 
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• The following are forms of register indirect memory operands: 
[pointer register] 
[index register] 
[pointer register + index register] 

where the pointer registers are BX and BP, and the index registers are SI and 
DI. Any of these forms can be preceded by a numeric offset, as in the 
following examples. 

ADD BX,[BP+SI] 

ADD BX,3[BP+SI] 

ADD BX,1D47[BP+SI] 

DDT-86 SAMPLE SESSION 

In the following sample session, a simple sort program is interactively debugged. 
Comments that explain the steps involved are in italics. 



Source file of program to test. 

A>type sort.a86 



sort: 



comp: 



inci: 



simple sort program 



mov 


si,0 


;initialize index 


mov 


bx,offset nlist 


;bx = base of list 


mov 


sw,0 


;clear switch flag 


mov 


al,[bx+si] 


;get byte from list 


cmp 


al,l[bx+si] 


;compare with next byte 


jna 


inci 


;don't switch if in order 


xchg 


al,l[bx+si] 


;do first part of switch 


mov 


[bx+si],al 


;do second part 


mov 


sw,l 


;set switch flag 


inc 


si 


increment index 


cmp 


si,count 


;end of list? 


jnz 


comp 


;no, keep going 


test 


sw,l 


;done - any switches? 


jnz 


sort 


;yes, sort some more 
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done: 



jmp done 

dseg 

org lOOh 



;get here when list ordered 
;leave space for base page 



nlist db 3,8,4,6,31,6,4,1 

count equ offset $ - offset nlist 

sw db 

end 

Assemble program. 

A>asm86 sort 

CP/M 8086 ASSEMBLER VER 1.1 

END OF PASS 1 

END OF PASS 2 

END OF ASSEMBLY. NUMBER OF ERRORS: 

Type listing file generated by ASM-86 

A>type sort. 1st 

CP/M ASM86 1.1 SOURCE: SORT. A86 



simple sort program 



sort: 



0000 BE0000 


mov 


si,0 


initialize index 


0003 BB0001 


mov 


bx,offset nlist 


;bx = base of list 


0006 C606080100 


mov 
comp: 


sw,0 


;clear switch flag 


000B 8A00 


mov 


al,[bx+si] 


;get byte from list 


000D3A4001 


cmp 


al,l[bx+si] 


;compare with next byte 


0010 760 A 


jna 


inci 


;don't switch if in order 


0012 864001 


xchg 


al,l[bx+si] 


;do first part of switch 


0015 8800 


mov 


[bx+si],al 


;do second part 


0017 C606080101 


mov 


sw, 1 


;set switch flag 


001C 46 


inci: 

inc 


si 


increment index 


001D83FE08 


cmp 


si,count 


;end of list? 
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0020 75E9 




jnz 


comp 


0022 F606080101 




test 


sw,l 


0027 75D7 


done: 


jnz 


sort 


0029 E9FDFF 


? 


jmp 
dseg 


done 






org 


lOOh 


0100 030804061F.06 


5 

nlist 


db 


3,8,4,6,31,6,4,1 



;no, keep going 
;done - any switches? 
;yes, sort some more 

;get here when list ordered 
;leave space for base page 



0401 
0008 count equ offset $ - offset nlist 

0108 00 sw db 

end 

END OF ASSEMBLY. NUMBER OF ERRORS: 

Type symbol table file generated by ASM-86. 

A>type sort.sym 

0000 VARIABLES 

0100 NLIST 0108 SW 

0000 NUMBERS 
0008 COUNT 

0000 LABELS 

000B COMP 0029 DONE 00 1C INCI 0000 SORT 



Type hex file generated by ASM-86. 

A>type sort.h86 
0400000300000000F9 

1B000081BEOOOOBB0001C6060801008A003A4001760A8640018800C60608016C 
11001B81014683FE0875E9F60608010175D7E9FDFFEE 
09010082030804061F0604010035 
0000000 IFF 

Generate CMD file from H86file. 

A>gencmd sort 

BYTES READ 0039 

RECORDS WRITTEN 04 



6-19 



DDT-86 



Invoke DDT-86 and load SORT. CMD. 

A>ddt86 sort 
DDT86 1.0 

START END 
CS 047D:0000 047D:002F 
DS 0480 :0000 0480 :010F 

Display initial register values. 



MOV 



AX BX CX DX SP BP SI DI CS DS SS ES IP 

0000 0000 0000 0000 119E 0000 0000 0000 047D 0480 0491 0480 0000 
SI, 0000 



Disassemble the beginning of the code segment. 



-1 

047D:0000 


MOV 


SI,0000 


047D:0003 


MOV 


BX,0100 


047D:0006 


MOV 


BYTE [0108],00 


047D:000B 


MOV 


AL,[BX+SI] 


047D:000D 


CMP 


AL,01[BX+SI] 


047D:0010 


JBE 


001C 


047D:0012 


XCHG 


AL,01[BX+SI] 


047D:0015 


MOV 


[BX+SI],AL 


047D:0017 


MOV 


BYTE[0108],01 


047D:001C 


INC 


SI 


047D:001D 


CMP 


SI,0008 


047D:0020 


JNZ 


000B 



Display the start of the data segment. 

-dl00,10f 

0480:0100 03 08 04 06 IF 06 04 01 00 00 00 00 00 00 00 00 



Disassemble the rest of the code. 

-1 

047D:0022 TEST BYTE [0108],01 

047D:0027 JNZ 0000 

047D:0029 JMP 0029 

047D:002C ADD [BX+SI],AL 

047D:002E ADD [BX+SI],AL 

047D:0030 DAS 



6-20 



DDTS6 



047D:0031 


ADD 


[BX+SI],AL 


047D:0033 


??= 


6C 


047D:0034 


POP 


ES 


047D:0035 


ADD 


[BX],CL 


047D:0037 


ADD 


[BX+SI],AX 


047D:0039 


??= 


6F 



Execute program from IP (=0) setting breakpoint at 29H. 

-g,29 

*047D:0029 



Breakpoint encountered. Display sorted list. 

-dl00,10f 

0480:0100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 



Doesn't look good. Reload file. 
-esort 

START END 
CS 047D:0000 047D:002F 
DS 0480 :0000 0480 :010F 



Trace 3 instructions. 

-t3 



Z-P- 

Z-P- 

Z-P- 

*047D:000B 



AX BX CX DX SP BP SI DI IP 

0000 0100 0000 0000 119E 0000 0008 0000 0000 MOV 

0000 0100 0000 0000 119E 0000 0000 0000 0003 MOV 

0000 0100 0000 0000 119E 0000 0000 0000 0006 MOV 



SI.0000 
BX,0100 
BYTE [0108],00 



Trace some more. 

-t3 



Z-P 

Z-P 

— S-A-C 

*047D:001C 



AX BX CX DX SP BP SI DI IP 

0000 0100 0000 0000 119E 0000 0000 0000 000B MOV 

0003 0100 0000 0000 119E 0000 0000 0000 000D CMP 

0003 0100 0000 0000 1 19E 0000 0000 0000 0010 JBE 



AL, [BX + SI] 
AL, 01 [BX + SI] 
001C 



Display unsorted list. 

-dl00,10f 

0480:0100 03 08 04 06 



IF 06 04 01 00 00 00 00 00 00 00 00 
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Display next instructions to be executed. 

-1 

047D:001C INC SI 

047D:001D CMP SI,0008 

047D:0020 JNZ OOOB 

047D:0022 TEST BYTE [0108],01 

047D:0027 JNZ 0000 

047D:0029 JMP 0029 

047D:002C ADD [BX+SI],AL 

047D:002E ADD [BX+SI],AL 

0.47D:0030 DAS 

047D:0031 ADD [BX+SI],AL 

047D:0033 ??= 6C 

047D:0034 POP ES 



Trace some more. 

-t3 



— S-A-C 
C 

— S-APC 

*047D:000B 



AX BX CX DX SP BP SI DI IP 

0003 0100 0000 0000 119E 0000 0000 0000 001 C 
0003 0100 0000 0000 119E 0000 0001 0000 00 ID 
0003 0100 0000 0000 119E 0000 0001 0000 0020 



INC SI 
CMP SI,0008 
JNZ OOOB 



Display instructions from, current IP. 



047D:000B 


MOV 


AL,[BX+SI] 


047D:000D 


CMP 


AL,01[BX+SI] 


047D:0010 


JBE 


001C 


047D:0012 


XCHG 


AL,01[BX+SI] 


047D:0015 


MOV 


[BX+SI],AL 


047D:0017 


MOV 


BYTE[0108],01 


047D:001C 


INC 


SI 


047D-.001D 


CMP 


SI,0008 


D47D:0020 


JNZ' 


OOOB 


047D:0022 


TEST 


BYTE [0108],01 


047D.-0027 


JNZ 


0000 


047D-.0029 


JMP 


0029 
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-t3 

AX BX CX DX SP BP SI DI IP 
— S-APC 0003 0100 0000 0000 119E 0000 0001 0000 000B 
— S-APC 0008 0100 0000 0000 119E 0000 0001 0000 000D 

0008 0100 0000 0000 119E 0000 0001 0000 0010 

*047D:0012 



MOV 
CMP 
JBE 



AL,[BX+SI] 

AL,01[BX+SI] 

001C 



047D:0012 


XCHG 


AL,01[BX+SI] 


047D:0015 


MOV 


[BX+SI],AL 


047D:0017 


MOV 


BYTE[0108],01 


047D:001C 


INC 


SI 


047D:001D 


CMP 


SI,0008 


047D:0020 


JNZ 


000B 


047D:0022 


TEST 


BYTE[0108],01 


047D:0027 


JNZ 


0000 


047D:0029 


JMP 


0029 


047D:002C 


ADD 


[BX+SI],AL 


047D:002E 


ADD 


[BX+SI],AL 


047D:0030 


DAS 




Go until switch has been performed. 


-g,20 






*047D:0020 







Display list. 

-dlOO.lOf 

0480:0100 03 04 08 06 IF 06 04 01 01 00 00 00 00 00 00 00 



Looks like 4 and 8 were switched okay. (And toggle is true.) 

-t 

AX BX CX DX SP BP SI DI IP 
— S-APC 0004 0100 0000 0000 119E 0000 0002 0000 0020 JNZ 
*047D:000B 



000B 
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Display next instructions. 



047D:000B 


MOV 


AL,[BX+SI] 


047D:000D 


CMP 


AL,01[BX+SI] 


047D:0010 


JBE 


001C 


047D:0012 


XCHG 


AL,01[BX+SI] 


047D.0015 


MOV 


[BX+SI],AL 


047D:0017 


MOV 


BYTE [0108],01 


047D:001C 


INC 


SI 


047D:001D 


CMP 


SI,0008 


C47D.0020 


JNZ 


000B 


047D:0022 


TEST 


BYTE [0108],01 


047D:0027 


JNZ 


0000 


047D:0029 


JMP 


0029 



Since switch worked, reload and check boundary conditions. 

-esort 

START END 

CS 047D:0000 047D:002F 

DS 0480:0000 0480 :010F 

Make it quicker by setting list length to 3. (Could also have used s47d=\Q.) 

-aid 

047D:001D cmp si,3 

047D:0020 

Display unsorted list. 

-dlOO 

0480:0100 03 08 04 06 IF 06 04 01 00 00 00 00 00 00 00 00 

0480:0110 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

0480:0120 00 00 00 00 00 00 00 00 00 00 00 00 00 20 20 20 

Set breakpoint when first 3 elements of list should be sorted. 

-g,29 
*047D:0029 



See if list is sorted. 

-dl00,10f 

0480:0100 03 04 06 08 IF 06 04 01 00 00 00 00 00 00 00 00 



6-24 



DDT-86 



Interesting. The fourth element seems to have been sorted in. 
-esort 

START END 
CS 047D:0000 047D:002F 
DS 0480 :0000 0480 :010F 

Let's try again with some tracing. 

-aid 

047D:001D cmp si,3 

047D:0020 . 



- — Z-P- 

_ — z-p- 

- — Z-P- 
- — Z-P- 
- — Z-P- 
— S-A-C 
— S-A-C 
C 

— S-A-C 

*047D:000B 



AX BX CX DX SP BP SI DI IP 

0006 0100 0000 0000 119E 0000 0003 0000 0000 MOV SI,0000 

0006 0100 0000 0000 119E 0000 0000 0000 0003 MOV BX,0100 

0006 0100 0000 0000 1 19E 0000 0000 0000 0006 MOV BYTE [0108],00 

0006 0100 0000 0000 119E 0000 0000 0000 000B MOV AL,[BX+SI] 

0003 0100 0000 0000 119E 0000 0000 0000 000D CMP AL,01[BX+SI] 

0003 0100 0000 0000 119E 0000 0000 0000 0010 JBE 001C 

0003 0100 0000 0000 119E 0000 0000 0000 001C INC SI 

0003 0100 0000 0000 119E 0000 0001 0000 001D CMP SI,0003 

0003 0100 0000 0000 119E 0000 0001 0000 0020 JNZ 000B 



047D:000B MOV AL,[BX+SI] 

047D:000D CMP AL,01[BX+SI] 

047D:0010 JBE 001C 

047D:0012 XCHG AL,01[BX+SI] 

047D:0015 MOV [BX+SI],AL 

047D:0017 MOV BYTE [0108],01 

047D:001C INC SI 

047D:001D CMP Sl,0003 

047D:0020 JNZ 000B 

047D-.0022 TEST BYTE [0108],01 

047D:0027 JNZ 0000 

047D.0029 JMP 0029 
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-t3 

AX BX CX DX SP BP SI DI IP 
— S- A-C 0003 1 00 0000 0000 1 1 9E 0000 000 1 0000 000B MOV 
— S-A-C 0008 0100 0000 0000 1 19E0000 0001 0000 000D CMP 

0008010000000000 119E00000001 00000010 JBE 

*047D:0012 



AL,[BX+SI] 

AL,01[BX+SI] 

001C 



047D:0012 


XCHG 


AL,01[BX+SI] 


047D:0015 


MOV 


[BX+SI],AL 


047D-.0017 


MOV 


BYTE[0108],01 


047D:001C 


INC 


SI 


047D:001D 


CMP 


SI,0003 


047D:0020 


JNZ 


000B 


047D:0022 


TEST 


BYTE [0108],01 



-t3 

AX BX CX DX SP BP SI DI IP 

0008 0100 00000000 11 9E 0000 0001 0000 0012 XCHG 

0004 01000000 0000 119E0000 0001 00000015 MOV 

0004010000000000 119E0000 0001 0000 0017 MOV 

*047D:001C 

-dl00,10f 

0480:0100 03 04 08 06 IF 06 04 01 01 00 00 00 00 00 00 00 



AL,01[BX+SI] 

[BX+SI],AL 
BYTE[0108],01 



So far, so good. 

-t3 

AX BX CX DX SP BP SI DI IP 

0004 0100 0000 0000 1 19E0000 0001 0000 001C 

0004 0100 0000 0000 1 19E0000 0002 0000 001D 

-S-APC 0004 0100 0000 0000 1 19E0000 0002 0000 0020 
*047D:000B 



INC 


SI 


CMP 


SI,0003 


JNZ 


000B 



047D:000B MOV AL,[BX+SI] 
047D:000D CMP AL,01[BX+SI] 
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047D:0010 


JBE 


001C 


047D:0012 


XCHG 


AL,01[BX+SI] 


047D:0015 


MOV 


[BX+SI],AL 


047D:0017 


MOV 


BYTE [0108],01 


047D:001C 


INC 


SI 


047D:001D 


CMP 


SI,0003 


047D:0020 


JNZ 


000B 


047D:0022 


TEST 


BYTE[0108],01 


047D:0027 


JNZ 


0000 


047D:0029 


JMP 


' 0029 



-t3 

AX BX CX DX SP BP SI DI IP 
— S-APC 0004 01 00 0000 0000 119E 0000 0002 0000 000B MOV 
— S-APC 0008 01000000 0000 119E 0000 0002 0000 000D CMP 

0008010000000000 119E0000000200000010 JBE 

*047D:0012 



AL,[BX+SI] 

AL,01[BX+SI] 

001C 



Sure enough, it's comparing the third and fourth elements of the list. Reload program. 



-esort 



START END 


CS 047D:0000 047D:002F 


DS 0480 :0000 0480 


:010F 


-1 

047D:0000 MOV 


SI,0000 


047D:0003 MOV 


BX,0100 


047D:0006 MOV 


BYTE [0108],00 


047D:000B MOV 


AL,[BX+SI] 


047D:000D CMP 


AL,01[BX+SI] 


047D:0010 JBE 


001C 


047D:0012 XCHG 


AL,01[BX+SI] 


047D:0015 MOV 


[BX+SI],AL 


047D:0017 MOV 


BYTE[0108],01 


047D:001C INC 


SI 


047D:001D CMP 


SI,0008 


047D:0020 JNZ 


000B 
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Patch length. 

-aid 

047D:001D cmp si,7 
047D:0020 

Try it out. 

-g,29 
*047D:0029 

See if list is sorted. 

-dlOO.lOf 

0480:0100 01 03 04 04 06 06 08 IF 00 00 00 00 00 00 00 00 



Looks better. Install patch in disk file. To do this, must read CMD file including 
header, so we can use R command. 

-rsort.cmd 

START END 

2000:0000 2000:0 IFF 

First 80h bytes contain header, so code starts at 80h. 

-180 

2000:0080 MOV SI, 0000 

2000:0083 MOV BX,0100 

2000:0086 MOV BYTE [0108],00 

2000:008B MOV AL,[BX+SI] 

2000-.008D CMP AL,01[BX+SI] 

2000:0090 JBE 009C 

2000:0092 XCHG AL,01[BX+SI] 

2000:0095 MOV [BX+SI],AL 

2000:0097 MOV BYTE [0108],01 

2000:009C INC SI 

2000:009D CMP SI.0008 

2000:00A0 JNZ 008B 
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Install patch. 

-a9d 

2000:009D 
2000:00A0 



cmp si, 7 



Write file back to disk. (Length of file assumed to be unchanged since no length 
specified). 

-wsort.cmd 
Reload file. 



-esort 

START 



END 



CS 047D.0000 047D.002F 
DS0480 :0000 0480 :010F 

Verify that patch was installed. 



047D:0000 


MOV 


SI,0000 


047D:0003 


MOV 


BX,0100 


047D:0006 


MOV 


BYTE [0108],00 


047D:000B 


MOV 


AL,[BX+SI] 


047D:000D 


CMP 


AL,01[BX+SI] 


047D:0010 


JBE 


001C 


047D:0012 


XCHG 


AL,01[BX+SI] 


047D.-0015 


MOV 


[BX+SI],AL 


047D:0017 


MOV 


BYTE[0108],01 


047D.001C 


INC 


SI 


047D:001D 


CMP 


SI,0007 


047D:0020 


JNZ 


000B 



Run it. 

-g,29 
*047D:0029 
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Still looks good. Ship it! 

-d 100,1 Of 

0480:0100 01 03 04 04 06 06 08 IF 00 00 00 00 00 00 00 00 

- A C 

A> 



6-30 



Appendix A 

ASM-86 Invocation 




Command: 



ASM86 



Syntax: 



ASM86 filename {$ parameters] 
where filename 



parameters 



is the 8086 assembly source file. Drive 
and extension are optional. The default 
file extension is .A86. 

are a one-letter type followed by a 
one-letter device from the table below. 



Parameters: 

form: $ Td where T = type and d — device 

Table A-l Parameter Types and Devices 



DEVICES 


PARAMETERS 




A 


H 


P 


S 


F 


A-H 


X 


X 


X 


X 






X 


X 


X 


X 


X 






Y 


X 


X 


X 


X 






x = valid, d = default 
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Table A-l Parameter Types and Devices (cont'd) 



DEVICES 


PARAMETERS 




A 


H 


P 


S 


F 


Z 
I 
D 


X 


X 


X 


X 


X 

d 


x = valid, d = default 



Valid Parameters 

Except for the F type, the default device is the current default drive. 



Table A-2 Parameter Types 




controls location of ASSEMBLER source file 
controls location of HEX file 
controls location of PRINT file 
controls location of SYMBOL file 
controls type of hex output FORMAT 
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Table A-3 Device Types 


A-H 


Drives A-H 


X 


console device 


Y 


printer device 


Z 


byte bucket 


I 


Intel hex format 


D 


Digital Research hex format 



Table A-4 Invocation Examples 



ASM86 IO 


Assemble file IO.A86, produce 




IO.HEX IO.LST and IO.SYM. 


ASM86 IO.ASM $ AD SZ 


Assemble file IO.ASM on device D, 




produce IO.LST and IO.HEX, no 




symbol file. 


ASM86 IO $ PY SX 


Assemble file IO.A86, produce 




IO.HEX, route listing directly to 




printer, output symbols on console. 


ASM86 IO $ FD 


Produce Digital Research hex format. 


ASM86 IO $ FI 


Produce Intel hex format. 
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Mnemonic Differences from 
the Intel Assembler 




The CP/M 8086 assembler uses the same instruction mnemonics as the INTEL 8086 
assembler except for explicitly specifying far and short jumps, calls and returns. The 
following table shows the four differences. 



Table B-l Mnemonic Differences 




MNEMONIC FUNCTION 


CP/M 


INTEL 


Intra segment short jump: 


JMPS 


JMP 


Inter segment jump: 


JMPF 


JMP 


Inter segment return: 


RETF 


RET 


Inter segment call: 


CALLF 


CALL 
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ASM-86 HEXADECIMAL OUTPUT FORMAT 

ASM-86 produces machine code in either Intel or Digital Research hexadecimal 
format. The Intel format is identical to the format defined by Intel for the 8086. The 
Digital Research format is nearly identical to the Intel format, but adds segment 
information to hexadecimal records. Output of either format can be input to 
GENCMD, but the Digital Research format automatically provides segment iden- 
tification. A segment is the smallest unit of a program that can be relocated. 

Table C-l defines the sequence and contents of bytes in a hexadecimal record. Each 
hexadecimal record has one of the four formats shown in Table C-2. An example of 
a hexadecimal record is shown below. 

Byte number = > 123456789 n 

Contents = >:llaaaattddd c c CR LF 

Table C-l Hexadecimal Record Contents 



BYTE 


CONTENTS 


SYMBOL 





record mark 




1-2 


record length 


11 


3-6 


load address 


a a a a 


7-8 


record type 


1 1 


9-(n-l) 


data bytes 


dd d 


n-(n+l) 


check sum 


c c 


n+2 


carriage return 


CR 


n+3 


line feed 


LF 



C-l 



ASM-86 Hexadecimal Output Format 



Table C-2 Hexadecimal Record Formats 



RECORD TYPE 


CONTENT 


FORMAT 


00 


Data record 


:11 aaaa DT <data...> cc 


01 


End-of-file 
Extended address 


:00 0000 01 FF 


02 


mark 


:02 0000 ST ssss cc 


03 


Start address 


:04 0000 03 ssss iiii cc 


11 


=> record length — number of data bytes 


cc 


=> check sum — sum of all record bytes 


aaaa 


=> 16 bit address 


ssss 


=> 16 bit segment value 


iiii 


=> offset value of start address 


DT 


=> data record type 


ST 


=> segment address record type 



It is in the definition of record types 00 and 02 that Digital Research's hexadecimal 
format differs from Intel's. Intel defines one value each for the data record type and 
the segment address type. Digital Research identifies each record with the segment 
that contains it, as shown in Table C-3. 

Table C-3 Segment Record Types 



SYMBOL 


INTEL'S 
VALUE 


DIGITAL'S 
VALUE 


MEANING 


DT 


00 


81H 
82H 
83H 
84H 


for data belonging to all 8086 segments 
for data belonging to the CODE segment 
for data belonging to the DATA segment 
for data belonging to the STACK segment 
for data belonging to the EXTRA segment 
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Table C-3 Segment Record Types (cont'd) 





INTEL'S 


DIGITAL'S 




SYMBOL 


VALUE 


VALUE 


MEANING 


ST 


02 




for all segment address records 






85H 


for a CODE absolute segment address 






86H 


for a DATA segment address 






87H 


for a STACK segment address 






88H 


for a EXTRA segment address 



ASM-86 SYMBOL FILE FORMAT 

The .SYM file produced by ASM-86 has the following characteristics. 

• There is a form feed at the start of the file. 

• Symbols are alphabetized within groups. 

• Tabs are expanded if symbols are sent to the printer ($SY). 

INCLUDE FILES 

INCLUDE files have the following characteristics. 

• The filetype defaults to . A86 if no extension is specified. 

• The filetype may have fewer than three characters. 

• The system defaults to the same drive as the source file when $A is used in 
the command. 

• ASM-86 aborts if the file is not found. 

ASM-86 List File Format 

The .LST file produced by ASM-86 has the following characteristics. 

• There is a form feed at the start of the file. 

• There is no form feed at end of file. 

• There is no <cr> <lf> at the top of each page. 

• An absolute address field is given for relative instructions. 

• No spaces are placed between hex bytes. This allows more space for 
comments. 

• Errors are printed when NOLIST is active. 
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Table D-l Reserved Words 




Predefined Numbers 


BYTE 


WORD 


DWORD 




Operators 


EQ 


GE 


GT 


LE 


LT 


NE 


OR 


AND 


MOD 


NOT 


PTR 


SEG 


SHL 


SHR 


XOR 


LAST 


TYPE 


LENGTH 


OFFSET 




Assembler Directives 


DB 


DD 


DW 


IF 


RS 


RB 


RW 


END 


ENDM 


EQU 


ORG 


CSEG 


DSEG 


ESEG 


SSEG 


EJECT 


ENDIF 


TITLE 


LIST 


NOLIST 


INCLUDE 


SIMFORM 


PAGESIZE 


CODEMACRO 


PAGEWIDTH 


Codemacro Directives 


DB 


DD 


DW 


DBIT 


RELB 


RELW 


MODRM 


SEGFIX 


NOSEGFIX 
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Table D-l Reserved Words (cont'd) 



8086 Registers 


AH 


AL 


AX 


BH 


BL 


BP 


BX 


CH 


CL 


CS 


CX 


DH 


DI 


DL 


DS 


DX 


ES 


SI 


SP 


SS 



Instruction Mnemonics - See Appendix E. 
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ASM-86 Instruction Summary 

Table E-l ASM-86 Instruction Summary 




MNEMONIC 


DESCRIPTION 


AAA 


ASCII Adjust for Addition 


AAD 


ASCII Adjust for Division 


AAM 


ASCII Adjust for Multiplication 


AAS 


ASCII Adjust for Subtraction 


ADC 


Add with Carry 


ADD 


Add 


AND 


And 


CALL 


Call (intra segment) 


CALLF 


Call (inter segment) 


CBW 


Convert Byte to Word 


CLC 


Clear Carry 


CLD 


Clear Direction 


CLI 


Clear Interrupt 


CMC 


Complement Carry 


CMP 


Compare 


CMPS 


Compare Byte or Word (of string) 


CMPSB 


Compare String in Byte Form 


CMPSW 


Compare String in Word Form 


CWD 


Convert Word to Double Word 


DAA 


Decimal Adjust for Addition 


DAS 


Decimal Adjust for Subtraction 


DEC 


Decrement 


DIV 


Divide 


ESC 


Escape 


HLT 


Halt 


IDIV 


Integer Divide 


IMUL 


Integer Multiply 


IN 


Input Byte or Word 


INC 


Increment 


INT 


Interrupt 
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Table E-l ASM-86 Instruction Summary (cont'd) 


MNEMONIC 


DESCRIPTION 


INTO 


Interrupt on Overflow 


IRET 


Interrupt Return 


JA 


Jump on Above 


JAE 


Jump on Above or Equal 


JB 


Jump on Below 


JBE 


Jump on Below or Equal 


JC 


Jump on Carry 


JCXZ 


Jump on CX Zero 


JE 


Jump on Equal 


JG 


Jump on Greater 


JGE 


Jump on Greater or Equal 


JL 


Jump on Less 


JLE 


Jump on Less or Equal 


JMP 


Jump (intra segment) 


JMPF 


Jump (inter segment) 


JMPS 


Jump (8 bit displacement) 


JNA 


Jump on Not Above 


JNAE 


Jump on Not Above or Equal 


JNB 


Jump on Not Below 


JNBE 


Jump on Not Below or Equal 


JNC 


Jump on Not Carry 


JNE 


Jump on Not Equal 


JNG 


Jump on Not Greater 


JNGE 


Jump on Not Greater or Equal 


JNL 


Jump on Not Less 


JNLE 


Jump on Not Less or Equal 


JNO 


Jump on Not Overflow 


JNP 


Jump on Not Parity 


JNS 


Jump on Not Sign 


JNZ 


Jump on Not Zero 


JO 


Jump on Overflow 


JP 


Jump on Parity 


JPE 


Jump on Parity Even 


JPO 


Jump on Parity Odd 


JS 


Jump on Sign 


JZ 


Jump on Zero 


LAHF 


Load AH with Flags 
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Table E-l ASM-86 Instruction Summary (cont'd) 


MNEMONIC 


DESCRIPTION 


LDS 


Load Pointer into DS 


LEA 


Load Effective Address 


LES 


Load Pointer into ES 


LOCK 


Lock Bus 


LODS 


Load Byte or Word (of string) 


LODSB 


Load String in Byte Form 


LODSW 


Load String in Word Form 


LOOP 


Loop 


LOOPE 


Loop While Equal 


LOOPNE 


Loop While Not Equal 


LOOPNZ 


Loop While Not Zero 


LOOPZ 


Loop While Zero 


MOV 


Move 


MOVS 


Move Byte or Word (of string) 


MOVSB 


Move String in Byte Form 


MOVSW 


Move String in Word Form 


MUL 


Multiply 


NEG 


Negate 


NOT 


Not 


OR 


Or 


OUT 


Output Bye or Word 


POP 


Pop 


POPF 


Pop Flags 


PUSH 


Push 


PUSHF 


Push Flags 


RCL 


Rotate through Carry Left 


RCR 


Rotate through Carry Right 


REP 


Repeat 


RET 


Return (intra segment) 


RETF 


Return (inter segment) 


ROL 


Rotate Left 


ROR 


Rotate Right 


SAHF 


Store AH into Flags 


SAL 


Shift Arithmetic Left 


SAR 


Shift Arithmetic Right 
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Table E-l ASM-86 Instruction Summary (cont'd) 



MNEMONIC 


DESCRIPTION 


SBB 


Subtract with Borrow 


SCAS 


Scan Byte or Word (of string) 


SCASB 


Scan String in Byte Form 


SCASW 


Scan String in Word Form 


SHL 


Shift Left 


SHR 


Shift Right 


STC 


Set Carry 


STD 


Set Direction 


STI 


Set Interrupt 


STOS 


Store Byte or Word (of string) 


STOSB 


Store String in Byte Form 


STOSW 


Store String in Word Form 


SUB 


Subtract 


TEST 


Test 


WAIT 


Wait 


XCHG 


Exchange 


XLAT 


Translate 


XOR 


Exclusive Or 
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Sample Program 

Listing F-l Sample Program APPF.A86 

CP/M ASM86 1.1 SOURCE: APPF.A86 Terminal Input/Output PAGE 1 

title 'Terminal Input/Output' 
pagesize 50 
pagewidth 79 
simform 
****** Terminal I/O subroutines******** 



The following subroutines 
are included: 

CONSTAT — console status 
CONIN — console input 
CONOUT — console output 

Each routine requires CONSOLE NUMBER 
in the BL — register 



* Jump table: * 




CSEG 



start of code segment 
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0000 E90600 
0003 E91900 
0006 E92B00 



jmp_tab: 



jmp constat 
jmp conin 
jmp conout 



* I/O port numbers * 



CP/M ASM86 1.1 SOURCE: APPF.A86 Terminal Input/Output PAGE 2 



0010 
0011 
0011 
0001 
0002 



0012 
0013 
0013 
0004 
0008 



0009 53E83F00 
000D 52 





Terminal 1: 




instatl 


equ 


lOh 


; input status port 


indatal 


equ 


llh 


; input port 


outdatal 


equ 


llh 


; output port 


readyinmaskl 


equ 


Olh 


; input ready mask 


readyoutmaskl 


equ 


02h 


; output ready mask 




Terminal 2: 




instat2 


equ 


12h 


; input status port 


indata2 


equ 


13h 


; input port 


outdata2 


equ 


13h 


; output port 


readyinmask2 


equ 


04h 


; input ready mask 


readyoutmask2 


equ 


08h 


; output ready mask 




************* 






* CONSTAT * 






************* 





constat: 



constat 1: 



Entry: BL -reg = terminal no 
Exit: AL - reg = if not ready 
Offh if ready 

push bx ! call okterminal 



push dx 
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Sample Program 



OOOE B600 


mov 


dh,0 ; 


0010 8A17 


mov 


dl,instatustab [BX] 


0012 EC 


in 


al,dx 


0013 224706 


and 


al,readyinmasktab [bx] 


0016 7402 


jz 


constatout 


0018 BOFF 


mov 


al,0ffh 



; read status port 



CP/M ASM86 1.1 SOURCE: APPF.A86 Terminal Input/Output PAGE 3 
constatout: 



001A 5A5B0AC0C3 



001F53E82900 


conin: 


0023 E8E7FF 


coninl 


0026 74FB 




0028 52 




0029 B600 




002B 8A5702 




002E EC 




002F 247F 




0031 5A5BC3 





pop dx ! pop bx ! or al,al ! ret 



* CONIN * 



Entry: BL - reg = terminal no 
Exit: AL - reg = read character 



push bx ! call okterminal ! 

call constat 1 

jz coninl 

pushdx 

mov dh,0 

mov dl,indatatab [BX] 

in al,dx 

and al,7fh 

pop dx ! pop bx ! ret 






test status 



; read character 



; strip parity bit 



* CONOUT * 



Entry: BL - reg = terminal no 

AL - reg = character to print 



F-3 



Sample Program 



0034 53E8 1400 

0038 52 

0039 50 
003A B600 
003C8A17 

003E EC 



conout: 



conoutl: 



push bx ! call okterminal 

push dx 

push ax 

mov dh,0 ; test status 

mov dl,instatustab [BX] 

in al,dx 



CP/M ASM86 1.1 SOURCE: APPF.A86 Terminal Input/Output PAGE 4 

003 F 224708 and al,readyoutmasktab[BX] 

0042 74FA jz conoutl 

0044 58 pop ax ; write byte 

0045 8A5704 mov dl,outdatatab [BX] 

0048 EE out dx,al 

0049 5A5BC3 pop dx ! pop bx ! ret 



++++++++++++++ 
+ OKTERMINAL + 



Entry: BL - reg = terminal no 

okterminal: 

004C0ADB or bl,bl 

004E740A jz error 

0050 80FB03 cmp bljength instatustab + 1 

0053 7305 jae error 

0055 FECB dec bl 

0057 B700 mov bh,0 

0059 C3 ret 



005A 5B5BC3 error: pop bx ! pop bx ! ret ; do nothing 



* Data segment * 
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Sample Program 



0000 1012 
0002 1113 
0004 1113 
0006 0104 
0008 0208 



dseg 



* Data for each terminal * 



instatustab db 

indatatab db 

outdatatab db 

readyinmasktab db 

readyoutmasktab db 



instatl,instat2 
indatal,indata2 
outdata 1 ,outdata2 
readyinmask 1 ,readyinmask2 
ready outmask 1 ,readyoutmask2 



end 



END OF ASSEMBLY. NUMBER OF ERRORS: 
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Codemacro Definition Syntax 




<codemacro> : : = CODEMACRO <name> [<formal$list>] 
[<list$of$macro$directives>] 
ENDM 

<name> : : = IDENTIFIER 

<formal$list> : : = <parameter$descr>[{,<parameter$descr>}] 

<parameter$descr> : : = <form$name>:<specifier$letter> 

<modifier$letter>[(<range>)] 

<specifier$letter> :: = A|C|D|E|M|R|S|X 

<modifier$letter> : : = b | w | d | sb 

<range> : : = <single$range>|<double$range> 

<single$range> : : = REGISTER | NUMBERB 



<double$range> : : = 
<list$of$macro$directives> 



NUMBERB, NUMBERB | NUMBERB, REGISTER | 
REGISTER, NUMBERB I REGISTER, REGISTER 



<macro$directive> 
{<macro$directive>} 



<macro$directive> : : = <db> | <dw> | <dd> | <segfix> | 

<ncsegfix> | <modrm> | <relb> 
<relw> | <dbit> 

<db> : : = DB NUMBERB I DB <form$name> 
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Codemacro Definition Syntax 

<dw> : : = DW NUMBERW | DW <form$name> 

<dd> : : = DD <form$name> 

<segfix> : : = SEGFIX <form$name> 

<nosegfix> : : = NOSEGFIX <form$name> 

<modrm> : : = MODRM NUMBER7, <form$name> | 
MODRM <form$name>, <form$name> 

<relb> : : = RELB <form$name> 

<relw> : : = RELW <form$name> 

<dbit> : : = DBIT <field$descr>{,<field$descr>] 

<field$descr> : : = NUMBER15 ( NUMBERB ) | 

NUMBER15 ( <form$name> ( NUMBERB ) ) 

<form$name> : : - IDENTIFIER 

NUMBERB is 8 - bits 
NUMBERW is 16 - bits 
NUMBER7 are the values 0, 1, ..., 7 
NUMBER15 are the values 0, 1, ..., 15 
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ASM-86 Error 
Messages 




ASM-86 produces two types of error messages: fatal errors and diagnostics. Fatal 
errors occur when ASM-86 is unable to continue assembling. Diagnostic messages 
report problems with the syntax and semantics of the program being assembled. 
The following messages indicate fatal errors encountered by ASM-86 during 
assembly: 

NO FILE 

DISK FULL 

DIRECTORY FULL 

DISK READ ERROR 

CANNOT CLOSE 

SYMBOL TABLE OVERFLOW 

PARAMETER ERROR 

ASM-86 reports semantic and syntax errors by placing a numbered ASCII message 
in front of the erroneous source line. If there is more than one error in the line, only 
the first one is reported. Table H-l summarizes ASM-86 diagnostic error messages. 



Table H-l ASM-86 Diagnostic Error Messages 



NUMBER 


MEANING 



1 

2 
3 
4 


ILLEGAL FIRST ITEM 
MISSING PSEUDO INSTRUCTION 
ILLEGAL PSEUDO INSTRUCTION 
DOUBLE DEFINED VARIABLE 
DOUBLE DEFINED LABEL 



H-l 



ASM-86 Error Messages 



Table H-l ASM-86 Diagnostic Error Messages (cont'd) 


NUMBER 


MEANING 


5 


UNDEFINED INSTRUCTION 


6 


GARBAGE AT END OF LINE — IGNORED 


7 


OPERAND (S) MISMATCH INSTRUCTION 


8 


ILLEGAL INSTRUCTION OPERANDS 


9 


MISSING INSTRUCTION 


10 


UNDEFINED ELEMENT OF EXPRESSION 


11 


ILLEGAL PSEUDO OPERAND 


12 


NESTED "IF" ILLEGAL — "IF" IGNORED 


13 


ILLEGAL "IF" OPERAND — "IF" IGNORED 


14 


NO MATCHING "IF" FOR "ENDIF" 


15 


SYMBOL ILLEGALLY FORWARD REFERENCED — 




NEGLECTED 


16 


DOUBLE DEFINED SYMBOL — TREATED AS 




UNDEFINED 


17 


INSTRUCTION NOT IN CODE SEGMENT 


18 


FILE NAME SYNTAX ERROR 


19 


NESTED INCLUDE NOT ALLOWED 


20 


ILLEGAL EXPRESSION ELEMENT 


21 


MISSING TYPE INFORMATION IN OPERAND (S) 


22 


LABEL OUT OF RANGE 


23 


MISSING SEGMENT INFORMATION IN OPERAND 


24 


ERROR IN CODEMACRO BUILDING 
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DDT-86 Error Messages 




Table 1-1 DDT-86 Error Messages 



ERROR MESSAGE 


MEANING 


AMBIGUOUS OPERAND 


An attempt was made to assemble a 




command with an ambiguous oper- 




and. Precede the operand with the 




prefix "BYTE" or "WORD". 


CANNOT CLOSE 


The disk file written by a W com- 




mand cannot be closed. 


DISK READ ERROR 


The disk file specified in an R com- 




mand could not be read properly. 


DISK WRITE ERROR 


A disk write operation could not be 




successfully performed during a W 




command, probably due to a full 




disk. 


INSUFFICIENT MEMORY 


There is not enough memory to load 




the file specified in an R or E com- 




mand. 


MEMORY REQUEST DENIED 


A request for memory during an R 




command could not be fulfilled. Up 




to eight blocks of memory may be 




allocated at a given time. 
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Table 1-1 DDT-86 Error Messages (cont'd) 



ERROR MESSAGE 


MEANING 


NO FILE 
NO SPACE 

VERIFY ERROR AT s:o 


The file specified in an R or E com- 
mand could not be found on the disk. 

There is no space in the directory for 
the file being written by a W com- 
mand. 

The value placed in memory by a Fill, 
Set, Move, or Assemble command 
could not be read back correctly, 
indicating bad RAM or attempting to 
write to ROM or nonexistent memory 
at the indicated location. 
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Index 



A 

A86 Filename 1-1 
AAA 4-6, E-l 
AAD 4-6, E-l 
AAM 4-6, E-l 
above 4-13 
ace 4-1 
ADC 4-6, E-l 
ADD 4-7, E-l 
Addition, 2-12, 2-15 
Address Conventions in 

ASM-86 2-16 
Address Expression 2-16 
AF 4-3, 4-6 
AH 2-5, 5-9, D-2 
AL 2-6, 5-3, 5-9, D-2 
Allocate Storage 3-6 
AND 2-12, 4-8, D-l, E-l 
Apostrophe 2-3 
Arithmetic Instructions 4-6 
Arithmetic Operators 2-8, 2-10 
ASCII 2-4, 6-5 
ASM-86 1-2 

Aborting 1-2 

Commands 1-4 

Error Messages 1-2, H-l 

Instruction Summary E-l 

Invoking A-l 
Asterisk 2-2, 2-13 
At Sign 2-2 
AX 2-6, 5-3, 5-9, D-2 



B 

Bar Character 
below 4-13 



2-8 



BH 2-5, 5-9, D-2 

Binary constants 2-3 

BL 2-6, 5-9, D-2 

Boolean Logic 2-12 

BP 2-6, 5-9, D-2 

Bracketed Expression 2-16, 3-1 

Buslock 4-17 

BX 2-6, 5-9, D-2 

BYTE 2-7, 6-16, D-l, 1-1 

Bytes 2-4, 5-9, 6-16, C-l 



c 

CALL 4-13,6-16, E-l 

CALLF 4-14,6-16, B-l, E-l 

CBW 4-7, E-l 

CF 4-3,4-5 

CH 2-5, 5-9, D-2 

Character Set 2-1 

Character String 2-1,2-4 

CL 2-6, 5-9, D-2 

CLC 4-18, E-l 

CLD 4-18, E-l 

CLI 4-18, E-l 

CMC 4-18, E-l 

CMD 6-1,6-5 

CMP 4-7, E-l 

CMPS 4-12, 5-6, E-l 

CMPSB 4-12,6-16, E-l 

CMPSW 4-12,6-16, E-l 

CODE C-3 

Code Segment 3-1 

CODEMACRO 5-1, D-l, G-l 
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Index 



Codemacro 5-1 

Definition Syntax G-l 

Directives 5-5 

Modifiers 5-4 

Range Specifiers 5-4 

Specifiers 5-3 
Colon 2-2, C-l 
Comma 4-1 
Comments 2-17 
CON: 1-4 

Conditional Assembly 3-4 
Console Output 1-4 
Constants 2-3 

Control Transfer Instructions 4-12 
CPU 6-3, 6-12 
CR 2-2, 2-17, C-l 
Creation of Output Files 1-3 
CS 2-6, 2-13, 3-1, 5-9, 6-6, 6-13, D-2 
CSEG 3-1, D-l 
CTRL C 6-1 
CTRL H 6-1 
CTRL R 6-1 
CTRL S 1-4, 6-1 
CWD 4-7, E-l 
CX 2-6, 4-13, 5-9, D-2 



D 

DAA 4-7, E-l 

DAS 4-7, E-l 

DATA C-3 

Data Segment 3-1 

Data Transfer Instructions 4-3 

DB 2-4, 3-5, 5-2, 5-8, D-l 

DBIT 5-2, 5-8, D-l 

DD 3-5, 5-2, 5-8, D-l 

DDT-86 Commands 6-1 

A (Assemble) 6-2, 6-4, 6-13, 1-2 

Conventions 6-1 

D (Display) 6-2, 6-4 



E (Load for Execution) 6-2, 6-4, 
6-11,6-14,1-1 

F (Fill) 6-2,6-6,6-14,1-2 

G (Go) 6-2, 6-6, 6-14 

H (Hexadecimal Math) 6-2, 6-7, 
6-15 

I (Input Command Tail) 6-2, 6-7 

L (List) 6-2, 6-8, 6-13 

M (Move) 6-2, 6-8, 1-2 

R(Read) 6-2,6-5,6-9,6-11 
6-13,1-1 

S (Set) 6-2, 6-9, 1-2 

Sample Session 6-17 

Summary 6-2 

T (Trace) 6-2,6-10,6-14 

U(Untrace) 6-2,6-11,6-14 

V (Value) 6-2,6-11 

W (Write) 6-2,6-11,6-13,1-1 

X (Examine CPU) 6-2, 6-12, 6-14 
DDT-86, Error Messages 6-10, 1-1 
DDT-86, Invoking 6-1 
DDT-86, Terminating 6-3 
DEC 4-7, 5-9, E-l 
Decimal Constants 2-3 
Default Segment Values 6-13 
Defined Data Area 3-5 
Delimiters 2-1 
DF 4-3 

DH 2-5, 5-9, D-2 
DI 2-6, 4-11,5-9, D-2 
Directives 2-5, 3-1 
Directive Statement 2-17, 3-1 
Diagnostic Errors H-l 
DIV 4-7, E-l 
Division 2-15 
DL 2-6, 5-9, D-2 
Dollar Sign Operator 1-2, 2-2, 2-14, 

2-16, 3-2, A-l, G-l, 1-1 
DS 2-6, 2-13, 3-1, 5-9, 6-14, D-2 
DSEG 3-1, D-l 
DT C-2 
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Index 



DX 2-6, 5-9, D-2 

DW 3-6, 5-2, 5-8, 6-4, D-l 

DWORD 2-7, D-l 



E 



3-1 



Effective Address 

EJECT 3-8, D-l 

END 3-5, D-l 

ENDM D-l 

End-of-line 2-17 

ENDIF 3-4, D-l 

EQ 2-12, D-l 

EQU 1-1,2-7, 3-5, D-l 

Error Messages 1-1, D-l, H-l, 1-1 

ES 2-6, 2-13, 3-1, 4-11, 5-6, 5-9, D-2 

ESC 4-18, E-l 

ESEG 3-1, D-l 

Exclamation Point 2-3, 2-17, 3-1, 4-1 

Expressions 2-16 

EXTRA C-3 

Extra Segment 3-1 

F 

Fatal Errors H-l 

Filename Extensions 1-1, 3-4, 6-9 

Filetype 1-2 

Flag Bits 4-2 

Flag Registers 4-3 

Formal Parameters 5-1 

Form Name 5-8 

G 

GE 2-12, D-l 
GENCMD C-l 
greater than 4-13 
GT 2-12, D-l 

H 

H86 Filename 1-1,6-1 
Hexadecimal Format 1-1, 6-15, C-l 



Hexadecimal Digits 2-3 
Hexadecimal Record C-l 
HLT 4-18, E-l 
Hyphen 6-1,6-12 

I 

Identifiers 2-4 

IDIV 4-7, E-l 

IF 3-4, 4-3, D-l 

IF LIST 3-4 

IMUL 4-8, E-l 

IN 4-3, E-l 

INC 4-7, 6-16, E-l 

INCLUDE 3-4, C-3, D-l 

Initialized Storage 3-6 

Instructions 2-5 

Instruction Statement 2-17, 4-1, 5-1 

INT 4-14, E-l 

Interrupts 4-13, 6-3 

INTO 4-14, E-2 

Invoking ASM-86 1-1, A- 1 

IP 5-7, 6-6 

IRET 4-14, E-2 

Iterational Control 4-13 



J 

JA 4-14, E-2 

JAE 4-14, E-2 

JB 4-14, E-2 

JBE 4-15, E-2 

JC 4-15, E-2 

JCXZ 4-15, E-2 

JE 4-15, E-2 

JG 4-15, E-2 

JGE 4-15, E-2 

JL 4-15, E-2 

JLE 4-15, E-2 

JMP 2-14, 4-15,6-16, E-2 

JMPF 4-15, 6-16, B-l, E-2 

JMPS 2-14, 4-15, 6-16, B-l, E-2 
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Index 



JNA 4-15, E-2 
JNAE 4-15, E-2 
JNB 4-16, E-2 
JNBE 4-16, E-2 
JNC 4-16, E-2 
JNE 4-16, E-2 
JNG 4-16, E-2 
JNGE 4-16, E-2 
JNL 4-16, E-2 
JNLE 4-16, E-2 
JNO 4-16, E-2 
JNP 4-16, E-2 
JNS 4-16, E-2 
JNZ 4-16, E-2 
JO 4-16, E-2 
JP 4-16, E-2 
JPE 4-16, E-2 
JPO 4-16, E-2 
Jump 4-13 
JS 4-16, E-2 
JZ 4-16, E-2 



K 

Keywords 



2-5, 2-17, 4-1, B-1,D-1 



Labels 2-7,2-17,4-2 
LAHF 4-3, E-2 
LAST 2-14, D-l 
LDS 4-4, E-3 
LE 2-12, D-l 
LEA 4-4, E-3 
LENGTH 2-14, 3-7, D-l 
LES 4-4, E-3 
less than 4-13 
LF 2-2, 2-17, C-l 
LIST 3-9, D-l 
Location Counter 3-3 
LOCK 4-18, 6-15, E-3 
LODS 4-12, E-3 



LODSB 4-12, 6-16, E-3 
LODSW 4-12, 6-16, E-3 
Logical Operators 2-8, 2-15 
LOOP 4-17, 5-7, E-3 
LOOPE 4-17, E-3 
LOOPNE 4-17, E-3 
LOOPNZ 4-17, E-3 
LOOPZ 4-17, E-3 
LST Filename 1-1, C-3 
LST: 1-4 
LT 2-12, D-l 

M 

Macro 5-1 

MAC 5-1 

MCS-86 Assembly Language Reference 

Manual 4-1,5-6 

MCS-86 User's Manual 4-1 , 5-6 

mem 4-2 

Minus Sign 2-2 

Mnemonic Keywords 2-5, 2-17, 4-1, B-l 

MOD 2-12, D-l 

MODRM 5-2, 5-6, D-l 

MOV 2-8, 4-4, E-3 

MOVS 4-12, 5-6, E-3 

MOVSB 4-12, 6-16, E-3 

MOVSW 4-12, 6-16, E-3 

MUL 4-8, 5-1, E-3 

Multiplication 2-15 

N 

Name Field 2-18 

NE 2-12, D-l 

NEG 4-8, E-3 

NOIFLIST 3-4 

NOLIST 2-5, 3-9, D-l 

NO FILE 1-2 

NOSEGFIX 5-2, 5-6, D-l 

NOT 2-12,4-9,6-16, D-l, E-3 

NUL:l-4 
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Index 



numb 4-1, 5-8 
Number Symbols 2-8 
Numeric Constants 2-3 
Numeric Expression 2-16, 3-4 



o 

Octal Constants 2-3 

OF 4-3,4-6 

OFFSET 2-14, D-l 

Offset 2-7, 3-6 

Offset Value 3-1 

Operand Types 2-17, 4-1, 5-1 

Operator Precedence 2-15 

Operators 2-5, 2-8 
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